必须安装vim-go插件并正确配置Go工具链，缺一不可；需确认vim支持+job/+channel/+json，$GOPATH/bin在$PATH中，设置GOPROXY代理，初始化go.mod，且避免sudo运行vim。
直接用 vim 编辑 Go 文件没问题，但想获得跳转、补全、格式化、运行等完整开发体验，必须靠 vim-go 插件 + 正确的 Go 工具链配置。缺一不可，光装插件不配环境，90% 的功能会失效或报错。
vim-go 装不上或 :GoInstallBinaries 卡住
这不是插件问题，是 Vim 或 Go 环境没到位。
- 先确认
vim --version输出里有+job、+channel、+json——缺一个，vim-go就无法通信，命令根本不会响应 - 运行
go version确保 Go 已安装；再执行echo $GOPATH和echo $PATH | grep bin，确认$GOPATH/bin在$PATH中（否则gopls这类工具装了也找不到） - 国内用户必须设代理：在 shell 配置里加
export GOPROXY=https://goproxy.cn,direct，然后重启终端再进 vim；别信“不用代理也能下”，golang.org/x/域名基本不可达 - 别用
:GoInstallBinaries一键全装——容易卡在某个工具上。改用逐个装：:GoInstallBinaries gopls、:GoInstallBinaries goimports
gd 跳转失败或 :GoInfo 正常但补全不工作
说明 gopls 启动了，但没接上 LSP 层，或者项目结构不被识别。
- 检查
.vimrc是否有let g:go_gopls_enabled = 1（Vim 8.2+/Neovim 0.4+ 必须显式开启） - 进项目根目录，运行
go mod init example.com/foo—— 没go.mod，gopls就退化成 GOPATH 模式，跳转/补全基本废掉 - 禁用旧补全插件：比如
neocomplete或未适配 LSP 的deoplete，会和gopls抢控制权；推荐用原生asyncomplete（Vim）或nvim-cmp（Neovim） - 查日志定位：加
let g:go_gopls_log_level = "debug"，重启 vim 后执行:messages，看有没有failed to start gopls类错误
:GoRun 报 exec: 'go': executable file not found
Vim 进程压根没继承到系统的 $PATH，尤其 macOS GUI 启动或某些桌面环境常见。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 在 vim 里执行
:echo $PATH，对比终端里echo $PATH，如果缺/usr/local/bin、/opt/homebrew/bin或$GOPATH/bin，就是启动方式不对 - 不要从 Dock、Alfred 或桌面快捷方式直接启 vim GUI；改用终端内运行
vim，或配置快捷方式显式加载 shell（如 macOS 可用open -a MacVim --args --remote-silent配合 shell wrapper） - 临时硬编码（仅调试用）：
let $PATH = '/opt/homebrew/bin:/usr/local/bin:' . $PATH，但得知道which go真实路径 - 绝对别用
sudo vim开发——root 环境下go几乎肯定不在$PATH里
补全慢、保存卡顿、:GoBuild 太啰嗦
默认开了一堆实时 lint，不是 Vim 性能差，是配置过载。
- 关掉非必要检查：
let g:go_metalinter_enabled = ['vet', 'errcheck']（去掉staticcheck、golint等） - 禁用自动保存触发 lint：
let g:go_metalinter_autosave = 0，手动用:GoMetaLinter查问题更可控 -
:GoFmt默认调gofmt，但如果你习惯go fmt（支持模块内全部格式化），可设let g:go_fmt_command = "go" - 单文件快速运行别记命令：映射
nnoremap <leader>r :!go run %<cr>，按,r就执行当前文件
最常被忽略的是 go.mod 存在与否和 $PATH 继承问题——这两点不解决，其他所有配置都是空中楼阁。
