| 旧组件 (VimScript) | 新组件 (Lua) | 状态 |
|---|---|---|
| YouCompleteMe (YCM) | nvim-lspconfig + nvim-cmp | ✅ 完成 |
| ALE | LSP diagnostics + conform.nvim | ✅ 完成 |
| NERDTree | nvim-tree.lua | ✅ 完成 |
| vim-airline | lualine.nvim | ✅ 完成 |
| vim-cpp-modern | nvim-treesitter | ✅ 完成 |
| vim-commentary | Comment.nvim | ✅ 完成 |
| AsyncRun | 保留 (兼容) | ✅ 完成 |
| Telescope | 保留 (Lua版) | ✅ 完成 |
| gitsigns | 保留 (Lua版) | ✅ 完成 |
- ✅ lazy.nvim - 现代化插件管理器(比 vim-plug 更快)
- ✅ Mason - LSP/formatter/linter 一键安装管理
- ✅ which-key - 交互式快捷键提示
- ✅ LuaSnip - 强大的代码片段系统
- ✅ nvim-treesitter - 精准的语法高亮和代码理解
# Windows
Rename-Item "$HOME\AppData\Local\nvim" "$HOME\AppData\Local\nvim.bak.$(Get-Date -Format 'yyyyMMdd')"
# Linux/macOS
mv ~/.config/nvim ~/.config/nvim.bak.$(date +%Y%m%d)# 方式 A: 使用安装脚本(推荐)
.\install-local.ps1
# 方式 B: 手动复制
New-Item -ItemType Directory -Force "$HOME\AppData\Local\nvim"
Copy-Item "init.lua" "$HOME\AppData\Local\nvim\init.lua"nvim首次启动会自动:
- 下载 lazy.nvim 插件管理器
- 安装所有插件
- 安装 Treesitter 语法解析器
- 等待几分钟完成初始化
启动 Neovim 后:
:Mason在 Mason 界面中:
i- 安装u- 更新X- 卸载
推荐安装:
- ✅
clangd(C/C++) - ✅
lua-language-server(Lua) - ✅
clang-format(格式化) - ✅
stylua(Lua 格式化)
或者自动安装(已配置):
-- init.lua 中已配置自动安装 clangd 和 lua_ls| 功能 | 旧键位 | 新键位 | 命令 |
|---|---|---|---|
| 切换文件树 | - | <C-n> |
:NvimTreeToggle |
| 切换文件树 | <leader>e |
<leader>e |
:NvimTreeToggle |
| 定位当前文件 | <leader>f |
<leader>f |
:NvimTreeFindFile |
| 兼容命令 | :NERDTreeToggle |
:NERDTreeToggle |
兼容别名 ✅ |
| 功能 | 旧键位 | 新键位 |
|---|---|---|
| 触发补全 | 自动2字符 | <C-Space> 或自动 |
| 选择下一项 | <Down> |
<Tab> 或 <Down> |
| 选择上一项 | <Up> |
<Shift-Tab> 或 <Up> |
| 确认 | <CR> |
<CR> |
| 关闭补全 | <C-y> |
<C-e> |
| 功能 | 旧键位 | 新键位 | 说明 |
|---|---|---|---|
| 下一个错误 | [e |
[e 或 [d |
完全兼容 |
| 上一个错误 | ]e |
]e 或 ]d |
完全兼容 |
| 查看诊断 | - | <leader>e |
浮动窗口 |
| 格式化 | :ALEFix |
<leader>lf 或 :ALEFix |
兼容命令 ✅ |
| QuickFix | - | <leader>q |
诊断列表 |
| 功能 | 键位 | 说明 |
|---|---|---|
| 跳转定义 | gd |
Go to definition |
| 跳转声明 | gD |
Go to declaration |
| 查找引用 | gr |
Find references |
| 查看文档 | K |
Hover documentation |
| 重命名 | <leader>rn |
Rename symbol |
| 代码操作 | <leader>ca |
Code actions |
| 签名帮助 | <C-k> |
Signature help |
| 功能 | 键位 | 命令 |
|---|---|---|
| Make | <F7> |
:AsyncRun make |
| Make run | <F8> |
:AsyncRun make run |
| Make test | <F6> |
:AsyncRun make test |
| 编译当前文件 | <F9> |
GCC/G++ 单文件编译 |
| 运行二进制 | <F4> |
运行编译结果 |
| QuickFix | <F10> |
:cwindow |
| 功能 | 键位 |
|---|---|
| 查找文件 | <leader>ff |
| 文本搜索 | <leader>fg |
| 缓冲区 | <leader>fb |
| 帮助 | <leader>fh |
| 最近文件 | <leader>fo |
| 功能 | 键位 |
|---|---|
| 下一个 hunk | ]g |
| 上一个 hunk | [g |
| 暂存 hunk | <leader>hs |
| 重置 hunk | <leader>hr |
| 预览 hunk | <leader>hp |
| 功能 | 键位 |
|---|---|
| 退出插入 | fj 或 vv |
| 全选 | <C-A> |
| 删除空行 | <leader>k |
| 注释切换 | <leader>cc |
| 新标签页 | <leader>tn |
| 关闭标签页 | <leader>tc |
| 退出 | <leader>q |
旧 (YCM):
- 基于语义引擎
- 需要编译安装
- 配置复杂
- C/C++ 支持优秀
新 (LSP + nvim-cmp):
- 基于 Language Server Protocol
- 无需编译,即装即用
- 配置简单,统一接口
- 支持更多语言
- 更快的启动速度
- 更好的扩展性
旧 (ALE):
- 异步 linter
- 支持多种工具
- VimScript 实现
新 (LSP diagnostics):
- 原生 LSP 支持
- 实时诊断
- 更准确的错误提示
- Lua 实现,性能更好
- conform.nvim 处理格式化
旧 (NERDTree):
- 经典文件树
- VimScript 实现
- 功能完整但略显陈旧
新 (nvim-tree):
- Lua 原生实现
- 更快的性能
- 现代化 UI
- Git 集成更好
- 完全兼容 NERDTree 键位
A: 首次启动会安装插件,之后会很快。lazy.nvim 提供懒加载,实际会比旧配置更快。
A: 运行 :Lazy sync 同步所有插件。
A:
- 检查 LSP 服务器是否安装:
:Mason - 查看 LSP 状态:
:LspInfo - 查看日志:
:LspLog
A:
- 确保在插入模式
- 按
<C-Space>手动触发 - 检查 LSP 是否附加:
:LspInfo
A:
- 确保安装了 formatter:
:Mason - 检查
clang-format是否安装 - 手动触发:
<leader>lf
A:
# 恢复备份
Remove-Item "$HOME\AppData\Local\nvim" -Recurse -Force
Rename-Item "$HOME\AppData\Local\nvim.bak.YYYYMMDD" "$HOME\AppData\Local\nvim"A:
- 按
<Space>查看所有 leader 键位 - 使用
:WhichKey查看完整映射 - 参考本文档的键位对照表
| 配置 | 启动时间 | 插件数 |
|---|---|---|
| 旧 (VimScript) | ~150ms | 6-8 个 |
| 新 (Lua) | ~80ms | 20+ 个 |
原因: lazy.nvim 的懒加载策略,大部分插件按需加载。
| 配置 | 空闲 | 编辑中 |
|---|---|---|
| 旧 | ~50MB | ~120MB |
| 新 | ~40MB | ~100MB |
原因: Lua 原生实现,Treesitter 增量解析。
- 备份旧配置
- 安装新配置
- 日常使用,发现问题
- 熟悉新的 LSP 键位
- 使用 which-key 探索功能
- 调整个人习惯
- 修改
init.lua添加个人配置 - 安装额外插件
- 调整主题和 UI
安装完成后,验证以下功能:
- Neovim 正常启动
- 文件树可以打开 (
<C-n>) - LSP 补全工作 (打开 .cpp 文件按
<C-Space>) - 诊断显示正常 (打开有错误的文件)
- 格式化工作 (
<leader>lf) - 跳转定义工作 (
gd) - Telescope 搜索工作 (
<leader>ff) - AsyncRun 构建工作 (
<F7>) - Git 状态显示 (打开 git 仓库文件)
- Treesitter 高亮正常
恭喜完成从 VimScript 到 Lua 的现代化迁移!
下一步:
- 查看
:help lua-guide了解 Lua API - 浏览
:Lazy探索插件 - 运行
:Mason安装更多工具 - 按
<Space>探索所有快捷键
需要帮助?
:checkhealth- 健康检查:help- 帮助文档:Lazy help- 插件管理帮助
享受你的现代化 Neovim IDE! 🚀