能直接调试main.go或测试函数说明环境基本就位；但dlv未安装、launch.json中mode与program不匹配、断点不命中等问题有明确解法：需手动安装dlv并配置go.delvePath，mode必须为auto/exec/test之一且program路径正确，项目须含go.mod并配好GOPROXY，最后重启VSCode生效。
能直接调试 main.go 或测试函数，说明环境基本就位；但多数人卡在 dlv 找不到、launch.json 配错、或断点不命中——这些问题都有明确解法，不是玄学。
确认 dlv 调试器已安装且可执行
VSCode 的 Go 扩展依赖 dlv，但它不会自动装好，尤其在国内网络下常静默失败。
- 终端运行
dlv version，若报command not found，说明没装或不在PATH - 手动安装：运行
go install github.com/go-delve/delve/cmd/dlv@latest - 装完后检查路径：
go env GOPATH→ 进入${GOPATH}/bin看是否有dlv（macOS/Linux）或dlv.exe（Windows） - 如果 VSCode 仍找不到，打开设置搜索
go.delvePath，手动填入完整路径，例如/Users/xxx/go/bin/dlv
launch.json 中 mode 和 program 必须匹配调试目标
mode 决定 VSCode 怎么启动程序，配错会导致“无法启动”或“跳过断点”。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 调试主程序（含
func main()）：用"mode": "auto"（自动识别main.go），或"mode": "exec"+"program": "./main.go" - 调试单个测试函数：光标放在
func TestXXX(t *testing.T)内，设"mode": "test"，VSCode 会自动提取测试名 -
"program": "${workspaceFolder}"只在mode: "auto"或"mode": "test"下有效；mode: "exec"必须指向具体可执行文件或.go文件路径 - 别用
"mode": "debug"—— 它是旧版配置，新版扩展已弃用，会导致启动失败
断点不命中？检查 GOPROXY 和模块初始化状态
常见现象：加了断点，F5 启动后直接跑完，变量窗口空、调用栈无内容。根本原因常是 Go 模块未正确加载。
立即学习“go语言免费学习笔记（深入）”；
- 确保项目根目录有
go.mod文件；没有就先运行go mod init myproject - 国内用户必须配代理，否则
dlv启动时可能拉不到依赖包，导致调试器静默退出：运行go env -w GOPROXY=https://goproxy.cn,direct - 如果项目用了私有模块，补充
go env -w GOPRIVATE=git.example.com/private/*，否则dlv会跳过相关包的调试信息 - 重启 VSCode ——
go env修改后，VSCode 不会自动重读，必须重启才生效
最易被忽略的是 dlv 版本与 Go 版本兼容性：Go 1.21+ 推荐用 dlv@latest，但某些企业环境锁死 Go 1.19，就得固定装 dlv@v1.20.2，否则会出现 “unsupported version” 错误。
