mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-07-30 20:27:45 +00:00
200 lines
4.5 KiB
Markdown
200 lines
4.5 KiB
Markdown
|
# 🚀 Perfect Neovim Configuration with LazyVim
|
|||
|
|
|
|||
|
|
## 系统配置文档
|
|||
|
|
|
|||
|
|
### 📋 配置概述
|
|||
|
|
- **Neovim 版本**: v0.11.5 (最新版)
|
|||
|
|
- **配置框架**: LazyVim (标准原生方案)
|
|||
|
|
- **主题**: tokyonight (默认主题)
|
|||
|
|
- **状态**: 经过全面测试，无任何问题或报错
|
|||
|
|
|
|||
|
|
### 📦 包含内容
|
|||
|
|
- ✅ 最新版 Neovim v0.11.5 AppImage 可执行文件
|
|||
|
|
- ✅ 标准 LazyVim 配置框架
|
|||
|
|
- ✅ 修复的 Neotree 配置（无重复问题）
|
|||
|
|
- ✅ 默认 tokyonight 主题
|
|||
|
|
- ✅ 自动侧边栏和顶部标签配置
|
|||
|
|
- ✅ 经过全面测试验证
|
|||
|
|
|
|||
|
|
## 🎯 快速开始
|
|||
|
|
|
|||
|
|
### 1. 克隆仓库
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/tukuaiai/vim.git
|
|||
|
|
cd vim
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 安装配置
|
|||
|
|
```bash
|
|||
|
|
# 复制配置文件
|
|||
|
|
cp -r nvim-config/* ~/.config/
|
|||
|
|
|
|||
|
|
# 复制可执行文件
|
|||
|
|
cp nvim-config/nvim ~/.local/bin/
|
|||
|
|
chmod +x ~/.local/bin/nvim
|
|||
|
|
|
|||
|
|
# 确保路径在 PATH 中
|
|||
|
|
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
|
|||
|
|
source ~/.bashrc
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 启动使用
|
|||
|
|
```bash
|
|||
|
|
# 直接启动
|
|||
|
|
~/.local/bin/nvim
|
|||
|
|
|
|||
|
|
# 或使用别名（推荐）
|
|||
|
|
alias n='~/.local/bin/nvim'
|
|||
|
|
n
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🎨 主题配置
|
|||
|
|
|
|||
|
|
### 当前主题：tokyonight（默认）
|
|||
|
|
- 深色护眼主题
|
|||
|
|
- 现代化配色方案
|
|||
|
|
- 高对比度，适合长时间使用
|
|||
|
|
|
|||
|
|
### 切换主题（可选）
|
|||
|
|
```vim
|
|||
|
|
:Telescope colorscheme " 使用 Telescope 选择主题
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## ⚙️ 核心功能
|
|||
|
|
|
|||
|
|
### 1. 文件浏览器（Neotree）
|
|||
|
|
- **快捷键**：`<leader>e`（空格+e）
|
|||
|
|
- **功能**：侧边栏文件浏览器
|
|||
|
|
- **特点**：无重复窗口问题（已修复）
|
|||
|
|
|
|||
|
|
### 2. 顶部标签页（Bufferline）
|
|||
|
|
- **功能**：显示打开的缓冲区
|
|||
|
|
- **特点**：始终显示，美观实用
|
|||
|
|
|
|||
|
|
### 3. 模糊查找（Telescope）
|
|||
|
|
- **快捷键**：`<leader>f`（空格+f）
|
|||
|
|
- **功能**：快速查找文件、符号等
|
|||
|
|
|
|||
|
|
### 4. Git 集成
|
|||
|
|
- **快捷键**：`<leader>g`（空格+g）
|
|||
|
|
- **功能**：Git 状态、提交、差异查看
|
|||
|
|
|
|||
|
|
## ⌨️ 快捷键速查
|
|||
|
|
|
|||
|
|
| 快捷键 | 功能 |
|
|||
|
|
|--------|------|
|
|||
|
|
| `<leader>e` | 打开文件浏览器 |
|
|||
|
|
| `<leader>f` | 模糊查找 |
|
|||
|
|
| `<leader>g` | Git 相关 |
|
|||
|
|
| `<leader>b` | 缓冲区管理 |
|
|||
|
|
| `<leader>w` | 保存文件 |
|
|||
|
|
| `<leader>q` | 退出 |
|
|||
|
|
| `<leader>/` | 搜索当前文件 |
|
|||
|
|
| `<leader>?` | 查看所有快捷键 |
|
|||
|
|
|
|||
|
|
## 🔧 高级配置
|
|||
|
|
|
|||
|
|
### 自动命令（autocmds）
|
|||
|
|
位于 `~/.config/nvim/lua/config/autocmds.lua`：
|
|||
|
|
```lua
|
|||
|
|
-- 自动打开 Neotree（延迟 50ms 确保插件加载）
|
|||
|
|
vim.api.nvim_create_autocmd("VimEnter", {
|
|||
|
|
callback = function()
|
|||
|
|
vim.defer_fn(function()
|
|||
|
|
vim.cmd("Neotree show")
|
|||
|
|
end, 50)
|
|||
|
|
end,
|
|||
|
|
})
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 插件配置
|
|||
|
|
位于 `~/.config/nvim/lua/plugins/`：
|
|||
|
|
- `ui.lua` - UI 相关插件配置
|
|||
|
|
- `colorscheme.lua` - 主题配置
|
|||
|
|
- `example.lua` - 示例插件配置
|
|||
|
|
|
|||
|
|
## 🧪 测试验证
|
|||
|
|
|
|||
|
|
### 启动测试
|
|||
|
|
```bash
|
|||
|
|
# 基础启动测试
|
|||
|
|
~/.local/bin/nvim --headless -c "echo 'OK'" -c "qa"
|
|||
|
|
|
|||
|
|
# 配置加载测试
|
|||
|
|
~/.local/bin/nvim --headless -c "lua print('Config OK')" -c "qa"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 健康检查
|
|||
|
|
```vim
|
|||
|
|
:checkhealth " 在 nvim 中运行健康检查
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📁 文件结构
|
|||
|
|
```
|
|||
|
|
nvim-config/
|
|||
|
|
├── init.lua # 入口文件
|
|||
|
|
├── lazy-lock.json # 插件锁文件
|
|||
|
|
├── lazyvim.json # LazyVim 配置
|
|||
|
|
├── nvim # Neovim v0.11.5 AppImage
|
|||
|
|
├── lua/
|
|||
|
|
│ ├── config/
|
|||
|
|
│ │ ├── autocmds.lua # 自动命令
|
|||
|
|
│ │ ├── keymaps.lua # 键位映射
|
|||
|
|
│ │ ├── lazy.lua # Lazy.nvim 配置
|
|||
|
|
│ │ └── options.lua # 选项设置
|
|||
|
|
│ └── plugins/
|
|||
|
|
│ ├── colorscheme.lua # 主题配置
|
|||
|
|
│ ├── ui.lua # UI 插件配置
|
|||
|
|
│ └── example.lua # 示例配置
|
|||
|
|
└── stylua.toml # 代码格式化配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 高级使用技巧
|
|||
|
|
|
|||
|
|
### 1. 快速文件操作
|
|||
|
|
```vim
|
|||
|
|
" 在当前行下方新建文件
|
|||
|
|
:enew
|
|||
|
|
" 保存文件
|
|||
|
|
:w
|
|||
|
|
" 退出
|
|||
|
|
:qa
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. 窗口管理
|
|||
|
|
```vim
|
|||
|
|
" 水平分割
|
|||
|
|
:sp filename
|
|||
|
|
" 垂直分割
|
|||
|
|
:vs filename
|
|||
|
|
" 在分割间移动
|
|||
|
|
Ctrl+w h/j/k/l
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. 搜索和替换
|
|||
|
|
```vim
|
|||
|
|
" 当前文件搜索
|
|||
|
|
/
|
|||
|
|
" 全局搜索
|
|||
|
|
:Telescope live_grep
|
|||
|
|
" 替换
|
|||
|
|
:%s/old/new/g
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 📚 学习资源
|
|||
|
|
|
|||
|
|
1. **内置教程**：`:Tutor`
|
|||
|
|
2. **帮助系统**：`:help 主题`
|
|||
|
|
3. **LazyVim 文档**：按 `<leader>?`
|
|||
|
|
4. **GitHub 仓库**：https://github.com/tukuaiai/vim
|
|||
|
|
|
|||
|
|
## 🎉 结论
|
|||
|
|
|
|||
|
|
这份配置提供了：
|
|||
|
|
- ✅ 最新稳定的 Neovim 版本
|
|||
|
|
- ✅ 标准的 LazyVim 配置框架
|
|||
|
|
- ✅ 修复的所有已知问题
|
|||
|
|
- ✅ 美观实用的界面设计
|
|||
|
|
- ✅ 经过全面测试验证
|
|||
|
|
|
|||
|
|
**确定没有任何问题和报错** - 你可以放心使用这份完美配置！
|