go环境能跑go run不代表调试可用，必须手动安装dlv并配置path；program字段需填准确路径而非"."；调试需禁用优化(-n -l)并匹配构建tag和cgo环境；远程调试须mode、host、port、remotepath及apiversion全匹配。
Go 环境能跑 go run main.go 不代表调试可用，本地调试失败十有八九是 dlv 没装对、没被 IDE 正确识别，或项目结构不符合调试器预期。
go version 能输出 ≠ 调试环境就绪
很多用户执行 go version 成功后就以为万事大吉，结果点 Debug 时报错：could not launch process: fork/exec /path/to/dlv: no such file or directory。这说明 Go 编译器存在，但 Delve 调试器根本没安装，或者不在 $PATH 中。
必须手动安装 dlv：
- 运行
go install github.com/go-delve/delve/cmd/dlv@latest（注意不是go get，后者已弃用） - 安装后检查是否生效：
which dlv或dlv version - 如果提示 command not found，确认
$GOBIN或$GOPATH/bin已加入系统PATH，且终端已重启或执行过source ~/.zshrc（macOS）/source ~/.bashrc（Linux）/ 重开 PowerShell（Windows）
GoLand 中调试配置不生效的常见卡点
GoLand 默认会尝试自动发现 dlv，但经常失败——尤其当你用 Homebrew 安装 Go、或自定义了 GOBIN 路径时。
正确做法是手动指定：
- 进入
File → Settings → Go → Tools - 找到
Delve debugger项，点击...按钮，手动指向你本地的dlv可执行文件路径（例如/Users/xxx/go/bin/dlv） - 确保
Use GOPATH that’s defined in system environment勾选状态与你实际环境一致；若用 Go Modules（推荐），可忽略GOPATH相关设置 - 新建 Run Configuration 时，
Mode必须选Package或File，不能选Directory（旧版遗留选项，容易导致无法断点）
VS Code 调试失败：launch.json 配置易错项
VS Code 的 Go 扩展依赖 .vscode/launch.json 启动调试，但默认生成的配置常埋雷：
-
"program": "${workspaceFolder}"是对的，但前提是项目根目录下有main.go且属于package main；如果入口文件在子目录（如cmd/app/main.go），必须显式写成"program": "${workspaceFolder}/cmd/app" - 不要写
"mode": "exec"——这是给已编译二进制用的；调试源码必须用"mode": "debug" - 若项目含 cgo 或需要特定环境变量（如
CGO_ENABLED=1），必须在"env"字段中补全，否则调试时可能 panic - 修改
launch.json后务必保存，且确保当前打开的文件是main.go或已设断点的文件，否则 F5 启动时可能静默失败
go build 和 go run 的行为差异影响调试准备
调试器实际运行的是编译后的二进制，但 go run 是边编译边执行、不落地文件，而 dlv 调试依赖符号表，所以：
-
go run main.go成功 ≠dlv debug main.go一定成功；后者要求能生成完整调试信息（默认开启，但某些构建 tag 或-ldflags会剥离） - 调试前建议先执行一次
go build -o ./tmp.bin .，再用dlv exec ./tmp.bin测试是否能启动——绕过 IDE，快速定位是环境问题还是配置问题 - 如果你在 CI 或容器里调试，注意
dlv需要ptrace权限（Linux），Docker 启动时得加--cap-add=SYS_PTRACE
最常被忽略的一点：Go 1.21+ 默认启用 buildmode=pie（地址空间布局随机化），某些旧版 dlv 会因此加载失败；遇到 could not determine kind of binary 类错误，临时加 -gcflags="all=-N -l" 或升级 dlv 到 v1.23+ 即可解决。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
