必须手动安装dlv并配置path，program填准确路径如"${workspacefolder}/main.go"，调试需加"-gcflags -n -l"禁用优化；远程调试须mode、host、port等全匹配。
VSCode 调试 Go 程序失败，90% 是因为 dlv 没装对、program 路径填错，或编译优化关不掉——不是插件问题，也不是代码写错了。
dlv command not found 怎么办
VSCode 不会自动安装 dlv，它只调用系统 PATH 里已有的可执行文件。报这个错，说明终端能跑 go，但跑不了 dlv。
- 在终端执行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐） - 运行
dlv version，有输出才表示安装成功 - 检查
which dlv（macOS/Linux）或where dlv（Windows）是否返回路径；没返回就手动把$GOPATH/bin（通常是$HOME/go/bin）加进系统 PATH - Windows 用户别用 Git Bash 启动 VSCode——它的 PATH 和系统不一致，改用 PowerShell 或 cmd 启动
- 改完 PATH 必须重启 VSCode，它只在启动时读一次环境变量
launch.json 里 program 字段填什么
填错 program 会直接报 could not launch process: fork/exec: no such file or directory，这不是代码路径问题，是 Delve 根本没找到入口点。
- 单文件项目（如根目录只有
main.go）：填"${workspaceFolder}/main.go" - 多包项目（比如
cmd/myapp/main.go）：填"${workspaceFolder}/cmd/myapp"（这是包路径，不是文件路径） - 绝对不要填
"."、"./"或空字符串——Delve 不支持模糊路径 - 确保当前工作区根目录下存在
go.mod，否则 Delve 可能因模块解析失败而找不到依赖
断点打了但完全不命中
断点悬空，大概率是 Delve 编译出的二进制和你预期的代码不匹配，常见于构建 tag、CGO 或编译优化干扰。
- 在
launch.json的args里加上"-gcflags", "-N -l"：强制关闭内联和优化，保留完整调试信息 - 如果用了构建 tag（比如
//go:build dev），必须在args中同步指定，例如"-tags=dev" - 项目依赖 C 代码？显式设置
"env": {"CGO_ENABLED": "1"}，否则默认CGO_ENABLED=0会导致符号缺失 - 删掉
.vscode/dlv-*临时目录——Delve 有时缓存旧符号表，导致断点映射错位
调试时变量显示 <optimized out></optimized>
这不是配置错误，是 Go 编译器把变量优化掉了。Delve 读不到寄存器或栈帧里的值，只能靠编译参数拦住优化。
- 必须在
args中传-gcflags "-N -l"，缺一不可：-N关闭内联，-l关闭行号优化 - 仅加
-l不够，-N才能防止函数内联后变量彻底消失 - 远程调试或交叉编译时，要确保服务器端也用了相同
-gcflags参数构建，否则本地调试器无法对齐符号
最常被忽略的是 -N 和 -l 必须同时生效，且必须通过 args 透传给 Delve 启动过程——写在 go build 命令里没用，因为 VSCode 调试走的是 dlv debug 流程，不是你手敲的构建命令。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
