8000 GitHub - XHao/myvim: vim config for me · GitHub
[go: up one dir, main page]

Skip to content
XHaoPublic

About

vim config for me

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

100 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

myvim

this is the vim configuration

pre-condition

通常只需按下方「前置依赖」用包管理器安装 vim 即可;本节仅在需要自行编译 vim 时参考。

install 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。

install myvim

前置依赖

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 目标

目标 作用
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 加插件时,请同步:

  1. scripts/verify.vim 加一行能力检查
  2. doc/myvim.txt 加一节说明(:help myvim)

Quick Start(常用快捷键)

打开任意源文件后,最常用的操作:

键 作用
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') 守卫会自动跳过未满足的声明,不影响其他插件。带 ⚡ 的按文件类型延迟加载。

plugins

LSP servers (vim-lsp + pyright/gopls/jdtls/clangd)

重要: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 coding
  • pyright(Python):npm registry,npm install -g pyright
  • gopls(Go):proxy.golang.org,go install golang.org/x/tools/gopls@latest
  • jdtls(Java):brew bottle / ghcr.io,brew install jdtls

make coding 幂等,已装的组件会跳过。完成后 make verify 中相关 [WARN] 全部转为 [PASS]。

LSP 启用后,打字时自动弹补全 popup(asyncomplete-lsp 监听 LSP server 初始化事件自动注册 source)。

调试 (vimspector + CodeLLDB)

插件本体由 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 会自动生效,无需额外拷贝文件。

Claude Code (AI coding agent)

<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。

从 Vundle 迁移

2026-08 起插件管理器由 Vundle 换为 vim-plug,插件目录从 bundle/ 变为 plugged/。 2026-08 起进一步从 YCM 切换到 vim-lsp 全 LSP 架构(无需编译,C++/Python/Go/Java 全覆盖)。 升级后旧目录可手动删除:rm -rf ~/.vim/bundle

About

vim config for me

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0