VSCode调试Go提示dlv command not found，需手动安装Delve并确保其在PATH中；program字段应填源码路径或模块包路径，勿用模糊写法；断点不命中常因构建tag、CGO或优化导致，应配置args加"-gcflags -N -l"禁用优化。
VSCode 启动调试时提示 dlv command not found
说明 Go 项目里没装 Delve，或者装了但不在系统 PATH 里。VSCode 的调试器不会自动帮你装 dlv，它只调用已存在的可执行文件。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在终端运行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐方式） - 确认安装成功：运行
dlv version，看到输出即表示可用 - 如果 VSCode 还报错，重启它——它只在启动时读取一次 PATH，改完环境变量不重启无效
- Windows 用户注意：
dlv.exe要确保在%PATH%中，别只放在某个终端的临时路径里
launch.json 中 program 字段填什么才不报错
这个字段不是填源码路径，也不是填编译后的二进制名，而是告诉 Delve “从哪开始跑”。填错会导致 could not launch process: fork/exec ... no such file or directory。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 对单文件项目（如
main.go），填"program": "${workspaceFolder}/main.go" - 对多包项目，填入口包路径，比如
"program": "${workspaceFolder}/cmd/myapp"（对应cmd/myapp/main.go） - 千万别填
./或.—— Delve 不支持这种模糊写法，会直接失败 - 如果用了 Go Modules，确保当前工作区根目录下有
go.mod，否则 Delve 可能找不到依赖包
断点打上了但调试时完全不命中
常见于使用了构建 tag、CGO、或非标准 GOPATH/GOPROXY 设置的项目。Delve 编译时生成的调试信息和你实际运行的代码不匹配，断点就悬空了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查是否启用了构建 tag：在
launch.json中加"args": ["-tags=dev"]，和你命令行go run -tags=dev保持一致 - CGO_ENABLED=0 是默认行为，但如果项目依赖 C 代码，得显式设
"env": {"CGO_ENABLED": "1"} - 避免在
launch.json里写死"mode": "exec"——除非你真在调试已编译好的二进制；日常开发用"mode": "auto"或"mode": "exec"都不如默认的"mode": "test"/"mode": "exec"自动推导靠谱 - 删掉
./.vscode/下的dlv-*临时目录，Delve 有时缓存旧符号表
调试时变量显示 <optimized out></optimized> 或值为空
这是 Go 编译器做了内联或寄存器优化导致的，不是配置问题，而是构建参数没关优化。Delve 无法读取被优化掉的栈帧信息。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在
launch.json的dlvLoadConfig里加"followPointers": true和"maxVariableRecurse": 1，只是改善显示，不解决根源 - 真正有效的是：在
launch.json中加"dlvLoadConfig": { "followPointers": true, "maxArrayValues": 64, "maxStructFields": -1 }，但这只是让加载更全，不解决<optimized out></optimized> - 必须加构建参数：
"dlvArgs": ["--continue", "--headless", "--api-version=2"]没用；真正要加的是"env": {"GODEBUG": "mmap=1"}？不对——正确做法是：在launch.json中添加"env": {"GODEBUG": "mmap=1"}并不能禁用优化；应该用"args": ["-gcflags", "-N -l"]，其中-N关闭优化，-l禁用内联 - 注意：加了
-gcflags "-N -l"后二进制体积变大、运行变慢，仅用于调试阶段，别提交到 CI
