必须手动安装dlv并正确配置PATH，重启VS Code；program字段需填准确路径而非"."；调试需禁用优化（-N -l）并匹配构建tag和CGO环境；远程调试须mode、host、port、remotePath及apiVersion全匹配。
必须手动安装 dlv，VS Code 不会自动装它，PATH 没配对或没重启编辑器是调试失败最常见原因。
dlv 命令找不到？先确认安装和 PATH
VS Code 启动调试时提示 dlv command not found，不是插件问题，而是系统根本找不到 dlv 可执行文件。
- 在终端运行
go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.21+ 推荐方式） - 安装完成后，运行
dlv version—— 有输出即表示二进制可用 - 检查
dlv所在路径是否在PATH中：which dlv（macOS/Linux）或where dlv（Windows） - 如果没输出，把
$GOPATH/bin（默认是$HOME/go/bin）加进系统环境变量，并重启 VS Code（它只在启动时读一次 PATH） - Windows 用户特别注意：别用 Git Bash 启动 VS Code，它的 PATH 和系统不一致；改用 PowerShell 或 cmd 启动
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 编译器做了内联、死代码消除或跳过调试符号生成，断点就悬空了。
立即学习“go语言免费学习笔记（深入）”；
- 在
launch.json的args中加入"-gcflags", "-N -l"，强制禁用优化和内联 - 如果你用了构建 tag（如
//go:build integration），调试前得显式传入：在args加"-tags=integration" - CGO_ENABLED=0 或 =1 会影响调试行为，确保调试时的 CGO 环境和实际运行一致（可在
env字段中指定） - 修改代码后务必保存 —— Delve 启动前会自动 build，未保存 = build 失败 = 调试直接退出
远程调试要连上，mode 和 host/port 必须严格匹配
本地 VS Code 连远程服务器上的 dlv，靠的是 mode: "remote"，但只要 host、port、remotePath 有一处不一致，就会卡在连接阶段。
- 远程端先启动：在目标目录运行
dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./myapp - 本地
launch.json配置中："mode": "remote"、"host": "xxx.xxx.xxx.xxx"（不能是 localhost）、"port": 2345、"remotePath": "/path/on/server"（必须和远程exec的工作目录一致） -
apiVersion必须为2（Delve v1.20+ 默认），旧版配置apiVersion: 1会握手失败 - 防火墙/安全组要放行对应端口，且远程
dlv进程没被 kill 或超时退出
最容易被忽略的是：dlv 安装路径不在 PATH 里时，VS Code 即使装了 Go 插件也完全无感知；还有就是改完环境变量不重启 VS Code，等于白配。
