CN：3 分钟把 Neovim/Vim 变成 C/C++ 友好的 IDE，开箱即用支持嵌入式场景。
EN: Turn Neovim/Vim into an IDE for C/C++ in 3 minutes, tuned for embedded workflows.
⭐ 如果本配置对你有帮助，请顺手点个 Star！
https://github.com/magic-alt/nvim-cpp-ide
我们提供了两个版本供您选择：
- ⚡ lazy.nvim - 极速插件管理
- 🎯 Native LSP - clangd, lua_ls
- 💎 nvim-cmp - 现代化补全
- 🌲 Treesitter - 精准语法高亮
- 📦 Mason - LSP 服务器一键安装
- 🚀 更快的启动速度 (~80ms vs ~150ms)
⚠️ Neovim 0.11+ - 利用vim.lsp.config原生接口
👉 查看 Lua 迁移指南 / See Lua Migration Guide →
- ✅ YouCompleteMe - 成熟稳定
- ✅ ALE - 异步诊断
- ✅ 兼容经典 Vim - 如果您需要 Vim 兼容性，使用此版本
选择指南：
- 使用 Neovim 0.10+ → 推荐 Lua 版本
- 需要 Vim 兼容 或喜欢 YCM → 使用 VimScript 版本
- 🚀 One-command setup / 一键部署：
install.sh或内置:MagicInstall（Vim/Neovim 均可）。 - 🪟 Unified Windows bootstrap：
install-lua.ps1支持远程安装、本地调试与首次插件同步。 - 💡 Smart completion：YouCompleteMe tuned for C/C++/Python（2-char trigger，clangd）。
- 🛡️ On-the-fly diagnostics：ALE 预置 GCC/C++17/交叉编译参数。
- ⚙️ Async build/run：AsyncRun 预置
make test/run、单文件 GCC 快速编译。 - 🌳 Project nav：NERDTree 快速跳转（
<leader>e/<leader>f/<leader>m）。 - 🎨 Ready-to-use UI：真彩色、稳定状态栏、现代 C++ 语法高亮。
- 🔧 Embedded-friendly：支持
compile_commands.json/compile_flags.txt，易接入交叉工具链。
Demo
# 1) 备份你的旧配置 / Backup
mv -f ~/.config/nvim ~/.config/nvim.bak.$(date +%Y%m%d) 2>/dev/null || true
# 2) 克隆并安装 / Clone and install
git clone --depth 1 https://github.com/magic-alt/nvim-cpp-ide.git /tmp/nvim-cpp-ide
mkdir -p ~/.config/nvim
cp /tmp/nvim-cpp-ide/init.lua ~/.config/nvim/init.lua
# 3) 打开 Neovim 自动安装插件 / Open and bootstrap
nvim# 一键安装 Lua 版本 / One-command install (Lua)
Set-ExecutionPolicy Bypass -Scope Process -Force; `
iwr https://raw.githubusercontent.com/magic-alt/nvim-cpp-ide/main/install-lua.ps1 -UseBasicParsing | iex脚本会自动备份旧配置、安装最新
init.lua并执行Lazy! sync。如需仅重新引导插件，运行.\install-lua.ps1 -FirstLaunchOnly；本地仓库调试可使用.\install-lua.ps1 -Local（默认会触发同样的首次同步）。
# 1) 备份你的旧配置 / Backup
mv -f ~/.config/nvim ~/.config/nvim.bak 2>/dev/null || true
mv -f ~/.vim ~/.vim.bak 2>/dev/null || true
# 2) 一键安装 / Install
bash -c "$(curl -fsSL https://raw.githubusercontent.com/magic-alt/nvim-cpp-ide/main/install.sh)"
# 3) 打开编辑器等待插件初始化 / Open and let it bootstrap
nvim || vim# 一键安装 VimScript 版本 / One-command install (VimScript)
Set-ExecutionPolicy Bypass -Scope Process -Force; `
iwr https://raw.githubusercontent.com/magic-alt/nvim-cpp-ide/main/install.ps1 -UseBasicParsing | iex或者在 Vim/Neovim 中执行：
:MagicInstall（已内置于config.vim）。
| 功能 | 插件 | 说明 |
|---|---|---|
| Plugin Manager | lazy.nvim | 懒加载、极速启动 |
| LSP | vim.lsp.config (Neovim 0.11+), mason.nvim | clangd, lua_ls 原生支持 |
| Completion | nvim-cmp, LuaSnip | 现代化补全引擎 |
| Formatting | conform.nvim | clang-format 等一键格式化 |
| Diagnostics | Native LSP diagnostics | 实时错误提示 |
| File Explorer | nvim-tree.lua | Lua 原生、Git 集成 |
| Syntax | nvim-treesitter | 精准语法高亮、AST 级别 |
| Search/Jump | Telescope | Fuzzy 查找文件/符号 |
| Git | gitsigns.nvim | 行内变更/Blame |
| UI | lualine.nvim, which-key | 现代状态栏与快捷键提示 |
| Async Build | AsyncRun（保留） | F6/F7/F8/F9/F10/F4 预设 |
| Comment | Comment.nvim | 智能注释 |
| 功能 | 插件 | 说明 |
|---|---|---|
| LSP/Completion | YouCompleteMe, clangd |
2 字符触发、语义补全 |
| Diagnostics | ALE | GCC/C++17 预置、状态栏集成 |
| Search/Jump | Telescope(可选) / 内置 | Fuzzy 查找文件/符号 |
| Git | gitsigns.nvim(可选) | 行内变更/Blame |
| UI | vim-airline, which-key |
状态栏与按键提示 |
| Syntax | vim-cpp-modern | 现代 C++ 关键字完整高亮 |
| Async | AsyncRun | F6/F7/F8/F9/F10/F4 预设 |
| Files | NERDTree | <leader>e/<leader>f |
重点语言：C/C++/Python（嵌入式友好）。更多语言可按指南扩展。
<leader>e/<leader>f：打开目录树 / 定位当前文件F7/F8/F6：make/make run/make test（AsyncRun）F9：单文件 GCC 快速编译；F10：切换 Quickfixfj或vv：退出插入模式<leader>cc：注释切换（支持可视模式）<leader>tn/<leader>tc：新建 / 关闭标签页
- Vim 8.0+（建议启用 Python3）或 Neovim 0.8+
- Python 3.6+、CMake ≥ 3.13、git、gcc/clang（交叉工具链可选）
详见 install.sh、uninstall.sh，或参考以下手动步骤与 FAQ（包含 The Ultimate vimrc 流程与 YCM 编译指引）。
- YCM 编译失败？ 请安装
build-essential cmake python3-dev，并执行install.py --clangd-completer。 - 颜色错乱？ 确保终端真彩：
TERM=xterm-256color。 - MagicInstall 无效？ 确认是通过本仓库的
config.vim打开并执行。
见 ROADMAP.md：启动速度对比、Windows 友好度、可选 minimal/full 两档配置等。
欢迎 PR！请先阅读 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md。 Issues/PR 模板与 CI 将帮助我们保持质量。