VS Code 调试 Go 失败的核心原因是环境变量、模块模式与 dlv 安装路径未对齐；dlv 必须安装在 $GOPATH/bin 或 $GOBIN 且该路径需在 PATH 中，项目必须含 go.mod 启用模块模式，否则 gopls 回退至 GOPATH 模式导致跳转失效、补全不准。
Go 环境在 Windows 上能跑起来，不等于 VS Code 能调好；90% 的调试失败、跳转失效、补全卡顿，根源不在插件没装全，而在环境变量、模块模式和 dlv 安装路径这三处没对齐。
go install dlv@latest 为什么总是提示 “Delve not found”
VS Code Go 插件默认只在 $GOPATH/bin 或 $GOBIN 里找 dlv，它不读你手动加进系统 PATH 的任意路径。常见错误包括：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest后没检查go env GOPATH和go env GOBIN—— 如果GOBIN为空，dlv就会落到$GOPATH/bin，但这个目录未必在当前 shell 的 PATH 里 - Windows 用户把
dlv.exe放进了含空格或中文的路径（比如C:\Program Files\Go\bin），VS Code 图形界面启动时解析失败 - 安装完没在终端执行
dlv version验证是否可运行；报command not found就说明路径根本没生效
launch.json 的 mode 和 program 怎么配才不灰点
断点变灰色 = VS Code 根本没加载源码上下文，大概率是 mode 和 program 搭配错了：
- 调试命令行程序（含
func main()）：用"mode": "auto"或"mode": "exec"，"program": "${workspaceFolder}"（自动找main.go）或明确写成"${workspaceFolder}/cmd/myapp/main.go" - 调试测试函数：必须用
"mode": "test"，且"args"至少包含"-test.run=TestXXX"；只改program到_test.go文件无效 - 调试已编译二进制：用
"mode": "exec"，"program"指向绝对路径（如"${workspaceFolder}/myapp"），但要求源码和编译时完全一致，否则断点错位
gopls 降级到 GOPATH 模式会导致什么
只要项目根目录没有 go.mod，gopls 就会回退到旧式 GOPATH 模式 —— 这不是 bug，是设计行为，后果很直接：
立即学习“go语言免费学习笔记（深入）”；
- 跳转定义失效（Ctrl+Click 变灰或跳错）
- 变量补全不准，甚至不出现
- 重命名操作只改局部，不跨文件
- 调试时变量显示为
main.x而不是x，断点命中率下降
新建项目第一件事就是运行 go mod init example.com/myproj，哪怕暂时没外部依赖。VS Code 打开后看右下角状态栏：如果显示 “Go (GOPATH)” 而不是 “Go (Go Modules)”，就说明已经掉坑里了。
Go 扩展提示“Install All Tools”却卡住或失败
VS Code Go 插件点击 “Install All Tools” 时，本质是批量执行 go install，失败原因往往隐蔽：
- 代理没设：国内用户不配
GO111MODULE=on和GOPROXY=https://goproxy.cn,direct，很多工具（如gopls、goimports）会超时失败 - 权限问题：Windows 下若以普通用户运行 VS Code，而
go install目标路径在C:\Go\bin这类受保护目录，会静默失败 - 版本冲突：插件默认拉最新版工具，但某些老项目依赖特定版本的
gopls，可手动指定，例如：go install golang.org/x/tools/gopls@v0.14.3
真正关键的不是装了多少工具，而是 dlv 路径对得上、go.mod 存在、代理可用——这三点稳了，其余工具大多只是锦上添花。
