this is the vim configuration
通常只需按下方「前置依赖」用包管理器安装 vim 即可;本节仅在需要自行编译 vim 时参考。
- git clone https://github.com/vim/vim.git
- 安装 python3-dev:sudo apt-get install -y python3-dev
- cd vim
- ./configure --with-features=huge --enable-multibyte --enable-rubyinterp=yes --enable-python3interp=yes --enable-perlinterp=yes --enable-luainterp=yes
- sudo make install
注意:UltiSnips 需要 python3 支持,编译后可用 vim --version | grep python3 确认是 +python3。
macOS(推荐用 brew 安装的 vim,自带 vim 无 python3,UltiSnips 不可用):
brew install git vim ctags node
Linux:
sudo apt-get install -y git vim exuberant-ctags nodejs npm
fzf、ripgrep、instant-markdown-d 由 make install 自动安装(检测 brew/apt-get,失败仅 WARN 不中断);也可单独 make deps 触发。
注意:Ubuntu 默认的 vim 可能不含 python3 支持(可改装 vim-nox),否则 UltiSnips 不可用;make verify 会检测并提示。
git clone https://github.com/XHao/myvim.git ~/.vim
cd ~/.vim
make install # 或 sh init.sh(兼容入口)
安装末尾会自动运行 make verify 输出体检报告;WARN 项按提示处理即可。
| 目标 | 作用 |
|---|---|
make install |
一键全装(前置检测 → 可选依赖 → 子模块 → vimrc 软链 → 插件 → help → verify) |
make deps |
自动安装可选依赖 fzf / ripgrep / instant-markdown-d(brew/apt-get,幂等) |
make update |
更新子模块与全部插件(更新后建议 make verify 复检) |
make verify |
分层验证:外部依赖 + 插件能力冒烟测试 |
make coding |
安装 LSP servers + 格式化器(pyright/gopls/jdtls/clang-format/black/google-java-format/prettier;不进入 make install 主流程) |
make plugins / help |
单独执行某一步 |
往 .vimrc 加插件时,请同步:
scripts/verify.vim加一行能力检查doc/myvim.txt加一节说明(:help myvim)
打开任意源文件后,最常用的操作:
| 键 | 作用 |
|---|---|
gd |
跳转定义(LSP) |
gr |
查找引用(LSP) |
K |
悬停文档(LSP) |
<leader>ca |
code action(quickfix / refactor) |
<leader>rn |
重命名符号 |
[d / ]d |
上一 / 下一诊断 |
<C-n> |
切换 NERDTree 文件树 |
<F8> |
切换 Tagbar 符号大纲 |
<C-p> |
fzf 模糊找文件 |
<leader>rg |
fzf ripgrep 全文搜索 |
<leader>jc |
fzf 检索 ~/.m2 依赖类(源码 jar → mvn 拉取 → vineflower 反编译) |
<leader><tab> |
UltiSnips 展开片段 / 跳到下一占位符 |
<leader>ai |
打开 Claude Code 终端(AI coding agent) |
<F5> |
调试:启动 / 继续(vimspector,项目需有 .vimspector.json) |
<F9> |
调试:断点开关 |
<C-o> |
跳回上一个位置(jumplist back) |
完整清单见 :help myvim。
make install 后,以下插件克隆到 ~/.vim/plugged/。带 ⚡ 的按文件类型延迟加载。各插件的命令与快捷键详见 :help myvim。
| 类别 | 插件 |
|---|---|
| 补全 / 片段 | ultisnips *, vim-snippets * |
| LSP / Go 开发 | vim-lsp, asyncomplete.vim, asyncomplete-lsp.vim, vim-go |
| 文件 / 跳转 | nerdtree, nerdtree-git-plugin, tagbar, fzf, fzf.vim, vim-fswitch ⚡, vim-gutentags |
| Git | vim-fugitive |
| 编辑增强 | auto-pairs, nerdcommenter, tabular ⚡ |
| 语言支持 | vim-cpp-enhanced-highlight ⚡, pangloss/vim-javascript ⚡, moll/vim-node ⚡, vim-markdown ⚡, vim-instant-markdown ⚡ |
| 界面 / 格式化 | vim-airline, vim-indent-guides, vim-codefmt, vim-maktaba, vim-glaive, molokai(配色) |
| 调试 | vimspector(CodeLLDB gadget 需单独装,见下) |
带 * 的需 vim +python3(macOS 自带 vim 无,须 brew install vim)。.vimrc 中 if has('python3') 守卫会自动跳过未满足的声明,不影响其他插件。带 ⚡ 的按文件类型延迟加载。
重要:make install 只克隆 vim 插件到 ~/.vim/plugged/,不装 LSP servers 与格式化器。要使用语义补全、跳转、code action 等现代 IDE 能力,必须单独执行:
make coding # 装 pyright/gopls/jdtls LSP servers + clang-format/black/google-java-format/prettier 格式化器
各组件来源:
clangd(C++):系统自带(Xcode CLT),无需make codingpyright(Python):npm registry,npm install -g pyrightgopls(Go):proxy.golang.org,go install golang.org/x/tools/gopls@latestjdtls(Java):brew bottle / ghcr.io,brew install jdtls
make coding 幂等,已装的组件会跳过。完成后 make verify 中相关 [WARN] 全部转为 [PASS]。
LSP 启用后,打字时自动弹补全 popup(asyncomplete-lsp 监听 LSP server 初始化事件自动注册 source)。
插件本体由 make plugins 安装;CodeLLDB gadget(lldb 的 DAP adapter)是下载物、不进 git,换机器后需在 vim 里执行一次:
:VimspectorInstall CodeLLDB
被调试项目在仓库根放 .vimspector.json 后,<F5> 选配置启动、<F9> 断点、<F10>/<F11> 单步、<leader>dq 结束。macOS 无 gdb,CodeLLDB 走系统 lldb。完整键表见 :help myvim-debug。
需要安装 instant-markdown-d:npm -g install instant-markdown-d
插件由 vim-plug 安装,自带的 ftplugin 会自动生效,无需额外拷贝文件。
<leader>ai / <leader>ab / <leader>aq 集成 Claude Code CLI(需 npm install -g @anthropic-ai/claude-code 或自定义启动器)。
默认交互启动 zsh -ic claude、pipe 用 claude、<leader>ai 宽屏竖开阈值 g:claude_vsplit_min(默认 160 列),均可通过 g:claude_cmd / g:claude_pipe_cmd / g:claude_vsplit_min 在 call plug#begin() 之前改写:
let g:claude_cmd = 'claude' " 直调 claude 二进制
let g:claude_cmd = 'zsh -ic claude' " 复用 zsh 函数(加载 .zshrc)
let g:claude_pipe_cmd = 'claude' " pipe 模式用裸 claude注:默认 zsh -ic claude 依赖 zsh(-i 用于加载 .zshrc 里的函数/别名);无 zsh 环境请改设 g:claude_cmd = 'claude' 直调二进制。
| 键 | 模式 | 作用 |
|---|---|---|
<leader>ai |
normal | 打开 Claude Code 终端(交互式;宽屏右侧 vsplit / 窄屏底部 20 行 split) |
<leader>ab |
visual | 选区 → Claude 改写(输出原地替换 buffer,失败可 u 撤销) |
<leader>aq |
visual | 选区 → Claude 查询(输出到终端,不改 buffer) |
任务分工建议:
- LSP(即时):跳转/重命名/code action/单行小改
- Claude Code(agentic):跨文件重构 / 写测试 / 读陌生代码 / 起草函数
<leader>ab:选区就地 AI 改写<leader>aq:选区就地 AI 查询
详见 :help myvim-ai。
2026-08 起插件管理器由 Vundle 换为 vim-plug,插件目录从 bundle/ 变为 plugged/。
2026-08 起进一步从 YCM 切换到 vim-lsp 全 LSP 架构(无需编译,C++/Python/Go/Java 全覆盖)。
升级后旧目录可手动删除:rm -rf ~/.vim/bundle