vim-go 插件装不上或不工作根本原因是网络导致gopls等工具下载失败，需设goproxy、手动执行:goinstallbinaries，确保go.mod存在、gopls版本≥v0.13，并配置gopls选项和格式化命令。
vim-go 插件装不上，PlugInstall 卡住或报错
根本原因通常是网络问题导致 vim-go 依赖的 Go 工具（如 gopls、goimports）下载失败，而不是插件本身安装失败。
- 先手动确认
go env GOPROXY是否为有效代理（推荐https://goproxy.cn或https://proxy.golang.org），不是就用go env -w GOPROXY=https://goproxy.cn,direct改掉 -
vim-go安装后不会自动下载工具，得进 Vim 执行:GoInstallBinaries—— 这步常被跳过，结果看起来“装了但不工作” - 如果
:GoInstallBinaries报context deadline exceeded，别反复重试，先关掉 Vim，终端里跑一遍GO111MODULE=on go install golang.org/x/tools/gopls@latest等关键命令，再重进 Vim
写代码时 gopls 不响应、跳转失效、补全卡顿
这是最常被当成“vim-go 不好用”的真实痛点，其实八成是 gopls 启动配置没对上当前项目结构。
- 确保项目根目录有
go.mod文件；没有的话，进目录执行go mod init example.com/foo，否则gopls会退化为文件级分析，跳转和类型推导基本失灵 - 检查
gopls版本是否太老：gopls version输出应含v0.13+；低于这个版本对 Go 1.21+ 的泛型支持差，补全常为空 - 在
.vimrc里加这行能稳住性能：let g:go_gopls_options = ['-rpc.trace']（调试用），日常建议换成：let g:go_gopls_options = ['--logfile', '/tmp/gopls.log']，出问题直接看日志比猜强得多
保存时自动格式化失效，go fmt 没跑、goimports 不生效
vim-go 默认不开启保存即格式化，必须显式打开，且不同格式化器行为差异大。
- 启用统一格式化：在
.vimrc加let g:go_fmt_autosave = 1，它默认调用gopls（推荐），不是go fmt - 想强制用
goimports替代gopls格式化：设let g:go_fmt_command = "goimports"，但注意goimports不处理空白行和括号换行，视觉上不如gopls“干净” - 如果保存后 import 块没重排，大概率是当前文件没被
gopls正确识别为 module 内部文件——检查:GoEnv输出里的GOPATH和GOROOT是否合理，尤其别让GOPATH指向$HOME/go却把项目放在别处
调试时 dlv 启动失败，报 could not launch process: fork/exec /path/to/dlv: no such file or directory
这不是路径没加进 $PATH，而是 vim-go 根本没找到 dlv 可执行文件，或者版本不兼容。
立即学习“go语言免费学习笔记（深入）”；
- 先终端执行
which dlv，拿到路径后，在.vimrc显式指定：let g:go_dlv_path = "/usr/local/bin/dlv"（替换成你的真实路径） -
dlv必须跟 Go 版本匹配：Go 1.21+ 强烈建议用dlv@master（go install github.com/go-delve/delve/cmd/dlv@master），旧版dlv在模块路径解析上会崩 - 调试前务必确认当前缓冲区是
.go文件且已保存（dlv调试不支持未保存的修改），且光标在main包内，否则:GoDebugStart会静默失败
gopls 和 dlv 这两个二进制的行为边界——它们高度依赖模块初始化状态、环境变量作用域、以及是否真的被 vim-go 正确调用。配完别急着写业务，先开个空 main.go，跑通 :GoInfo、:GoDef、:GoDebugStart 这三步，剩下的就是顺的。 
