必须手动安装dlv、正确配置path并重启vs code；program字段填准确路径而非"."；调试需禁用优化(-n -l)并匹配构建tag和cgo环境；远程调试须mode、host、port、remotepath及apiversion全匹配。
dlv command not found 是最常见原因，不是插件没装好，而是 dlv 二进制根本没被 VS Code 找到。必须手动安装、加进 PATH、重启编辑器，三步缺一不可。
dlv 命令找不到？先确认安装和 PATH
VS Code 不会自动帮你装 dlv，它只调用系统已有的可执行文件。
- 在终端运行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐方式） - 运行
dlv version，有输出才表示安装成功 - 检查
which dlv（macOS/Linux）或where dlv（Windows），没返回路径就说明不在PATH中 - 把
$GOPATH/bin（通常是$HOME/go/bin）加进系统环境变量，Windows 用户注意：别用 Git Bash 启动 VS Code，改用 PowerShell 或 cmd - 改完 PATH 必须重启 VS Code——它只在启动时读一次环境变量
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 可能因模块解析失败而找不到依赖
断点打了但完全不命中？大概率是优化或构建 tag 干扰
Delve 依赖未优化的二进制和完整调试信息。Go 编译器一旦做了内联、死代码消除或跳过调试符号生成，断点就悬空了。
- 在
launch.json的args中加入"-gcflags","-N -l"：强制关闭内联（-N）和行号优化（-l），缺一不可 - 如果用了构建 tag（如
//go:build dev），必须同步传入："-tags=dev" - 项目依赖 C 代码？显式设置
"env": {"CGO_ENABLED": "1"}，否则默认为0会导致符号缺失 - 删掉
.vscode/dlv-*临时目录——Delve 有时缓存旧符号表，导致断点映射错位
调试时变量显示 <optimized out></optimized> 怎么办
这不是配置错误，是编译器把变量优化掉了。Delve 读不到寄存器或栈帧里的值，只能靠编译参数拦住优化。
- 必须在
args中传-gcflags "-N -l"，仅加-l不够，-N才能防止函数内联后变量彻底消失 - 远程调试或交叉编译时，要确保服务器端也用了相同
-gcflags参数构建，否则本地调试器无法对齐符号 - 修改代码后务必保存——Delve 启动前会自动
build，未保存 = build 失败 = 调试直接退出
-gcflags "-N -l" 这两点最容易被忽略，尤其是 Windows 用户在 Git Bash 里装了 dlv 却用图形界面启动 VS Code，或者忘了重启编辑器；还有人以为加了 -l 就够了，结果变量还是 <optimized out></optimized>。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
