vim-go要求vim 8.0+（推荐8.2+或neovim 0.5+），需+job/+channel/+json支持；推荐vim-plug管理；gobin和goproxy必须正确配置；项目须有go.mod；禁用冗余lint可提升性能。
vim-go 插件装不上？先确认 Vim 版本和包管理器
vim-go 不支持 Vim 7.x，最低要求是 Vim 8.0+（推荐 Vim 8.2+ 或 Neovim 0.5+）。很多人卡在第一步：用系统自带的 Vim（比如 macOS 的 /usr/bin/vim）硬装，结果 :GoInstallBinaries 失败或命令根本不存在。
- 运行
vim --version | grep +job，必须看到+job、+channel、+json—— 缺一不可，否则vim-go的后台通信会直接瘫痪 - 别用
vim-plug以外的插件管理器硬套文档；如果用dein或pack，初始化顺序和go相关autocmd很容易漏，建议新手统一走vim-plug - macOS 用户优先装
brew install vim --with-override-system-vi，避免和系统 Vim 混淆
:GoInstallBinaries 总失败？Go 工具链路径和代理是关键
:GoInstallBinaries 不是“一键安装”，它本质是调用 go install 下载并编译十几个小工具（如 gopls、gotests、impl）。失败几乎都出在环境变量或网络上。
-
GOBIN必须设且写入权限正常，推荐显式设置：export GOBIN=$HOME/go/bin，然后确保该目录在$PATH中（否则 vim 启动后找不到gopls） - 国内用户不配
GOPROXY基本必挂，加这行到 shell 配置：export GOPROXY=https://goproxy.cn,direct - 如果提示
"cannot find package"或卡在Fetching golang.org/x/...，不是插件问题，是go命令本身连不上——换代理、删掉$GOPATH/pkg/mod/cache再试
gopls 启动报错 or 无法跳转？检查 go.mod 和 workspace 配置
gopls 是 vim-go 的语言服务器核心，但它只认标准 Go 工作区结构。没有 go.mod 的老项目、单文件测试、或 GOPATH 模式项目，gopls 会静默降级甚至拒绝启动。
- 进项目根目录，运行
go mod init example.com/foo（随便起个模块名），生成go.mod—— 这是激活完整功能的前提 - 不要在
~或空目录下打开.go文件，gopls会找不到 workspace，导致:GoDef返回"no identifier under cursor" -
vim-go默认启用gopls，禁用它只会退回更弱的guru（已废弃），别为了省事关掉；真要调参，改g:go_gopls_enabled为1（默认就是 1）
补全/诊断延迟高？关掉没必要的 lint 和 auto-save
vim-go 默认开一堆实时检查（golint、staticcheck、go vet），每敲几个字就触发一次，尤其在大项目里明显卡顿。这不是性能问题，是配置过载。
立即学习“go语言免费学习笔记（深入）”；
- 关掉非必要 lint：
let g:go_metalinter_enabled = ['vet', 'errcheck']（去掉staticcheck和golint，它们又慢又吵） - 禁用保存即检查：
let g:go_auto_type_info = 0、let g:go_jump_to_error = 0，把反馈时机交给手动:GoMetaLinter - 如果仍卡，检查是否启用了
g:go_fmt_autosave = 1—— 格式化本身不慢，但和gopls并发时容易冲突，建议设为0，用<leader>gf</leader>手动格式化
真正麻烦的是多模块项目里 gopls 加载 workspace 的边界判断——它不会自动识别 vendor 或 replace 路径，得靠 go.work 或正确设置 GOPATH。这点没人提，但实际踩坑最多。
