VS Code调试Go报“dlv command not found”主因是dlv未正确安装或未加入PATH：需用go install github.com/go-delve/delve/cmd/dlv@latest安装，确认$GOPATH/bin在PATH中并重启VS Code；launch.json中program须填准确路径（如"${workspaceFolder}/main.go"），禁用优化需加"-gcflags -N -l"。
VS Code 调试 Go 报 dlv command not found？不是插件没装好，而是 dlv 二进制根本没装进系统 PATH —— 这是 90% 的调试失败根源。
怎么装 dlv 才算真正装上
Go 1.16+ 必须用 go install，go get 已废弃且会污染模块依赖。别信旧教程里那行 go get -u github.com/go-delve/delve/cmd/dlv。
- 终端执行：
go install github.com/go-delve/delve/cmd/dlv@latest - 安装后，
dlv默认落在$GOPATH/bin（未设GOPATH就是$HOME/go/bin） - 必须把该路径加进系统
PATH：macOS/Linux 编辑~/.zshrc，Windows 在「系统环境变量」里追加 - 改完 PATH 后，新开终端运行
dlv version—— 有输出才算成功；VS Code 不重启，它根本读不到新 PATH
launch.json 里 program 字段填什么才不炸
填错 program 直接报 could not launch process: fork/exec: no such file or directory，和代码语法无关。
- 单文件项目（
main.go在根目录）："program": "${workspaceFolder}/main.go" - 多包项目（如入口在
cmd/myapp/main.go）："program": "${workspaceFolder}/cmd/myapp" - 绝对别填
"."或"./"—— Delve 不识别这种路径写法 - 确保项目根目录有
go.mod，否则 Delve 可能找不到依赖，build 阶段就失败
断点打了却完全不命中？先关掉优化
Delve 依赖编译器生成的调试信息，而 -ldflags="-s -w"、CGO 开启、或构建 tag 都会让调试信息丢失，断点悬空。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 在
launch.json的args里加："-gcflags", "-N -l"—— 强制禁用内联和优化 - 检查是否用了
//go:buildtag；调试时临时删掉或统一用go build默认 tag - CGO_ENABLED=0 有时能绕过某些兼容问题，但不是万能解；真要用 CGO，确保
CC环境变量指向可用编译器 - macOS 上若提示
not authorized to debug，需把 VS Code 或你用的终端（如 iTerm）拖进「系统设置 → 隐私与安全性 → 完全磁盘访问」
远程调试时 --headless 怎么配才安全
生产环境绝不能裸开 --listen=:2345，监听 0.0.0.0 等于把调试入口暴露给整个网络。
- 服务端启动命令：
dlv debug --headless --listen=127.0.0.1:2345 --api-version=2（只绑本地） - 本地用 SSH 隧道转发：
ssh -L 2345:127.0.0.1:2345 user@prod-server - VS Code 的
launch.json改成"mode": "attach"，"port": 2345，"host": "127.0.0.1" - 别省略
--api-version=2—— VS Code Go 扩展默认只认 v2 API，v1 已弃用
Delve 本身很轻量，真正卡住人的永远是 PATH、program 路径、优化标志这三处。尤其 program 填的是“启动入口”而非“编译目标”，这点和很多语言调试器逻辑相反，容易惯性踩坑。
