断点不命中是因为dlv未正确集成：需确认已用go install安装dlv且版本≥1.22，GoLand调试路径指向该dlv，编译时加-gcflags="-N -l"禁用优化，并确保远程调试时启用--headless和--api-version=2。
断点打不中，程序直接跑完？检查 dlv 是否已正确集成
GoLand 调试依赖 delve（dlv），不是内置的，也不是自动安装的。如果点击行号左侧加了断点但运行后没停，大概率是 dlv 没装、版本太旧，或 GoLand 指向了错误路径。
- 终端执行
dlv version确认已安装且版本 ≥ 1.21（Go 1.21+ 推荐用 dlv 1.22+） - GoLand 设置里搜
Go Tools→ 看Delve debugger路径是否指向你本地的dlv（比如/usr/local/bin/dlv） - 若用
go install github.com/go-delve/delve/cmd/dlv@latest安装，注意 GOPATH/bin 或 GOBIN 路径是否在系统 PATH 中 - Mac M 系列用户遇到
failed to launch process: fork/exec ... permission denied，通常是dlv未被允许全盘访问，需到「系统设置 → 隐私与安全性 → 完全磁盘访问」中添加 GoLand 和dlv
调试时变量显示 <not accessible> 或值为空？确认编译优化是否关闭
Go 编译默认开启优化（-gcflags="-l" 禁用内联，但不够），而调试器无法读取被优化掉的变量或调用栈。常见于 go run main.go 直接运行，或构建配置里残留 -ldflags="-s -w"。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- GoLand 默认 Run Configuration 使用
go run，它会隐式加-gcflags=all="-N -l"（禁用优化+内联），但仅限当前模块；若项目含 cgo 或 vendor，可能失效 - 手动验证：在终端执行
go build -gcflags="-N -l" -o testbin . && dlv exec ./testbin，再b main.main→r，看变量是否可读 - 若用
go build构建后再调试，必须显式加-gcflags="-N -l"，否则断点处局部变量大概率显示<not accessible>
想调试测试函数（go test）却进不去？别用 Run，要用 Test with Debugger
右键点击测试函数名或测试文件，选 Debug 'TestXXX'，而不是点绿色三角形 Run。后者走的是普通 go run 流程，不会触发测试框架初始化，自然进不了 func TestXxx(*testing.T)。
- 确保光标在
func TestXXX函数体内，或选中该函数名再右键 - 若测试依赖外部服务（如 DB、HTTP server），调试时端口冲突或超时更明显，建议先关掉无关进程，或改用内存 mock
- GoLand 2023.3+ 支持在
go.test.flags里加-test.run=^TestMyCase$精确匹配，避免误跑其他测试干扰断点 - 注意：
go test -count=1可防止测试被缓存跳过，确保每次调试都真实执行
远程调试容器内 Go 程序，dlv 启动参数和端口映射容易漏掉关键项
本地 GoLand 连不上容器里的 dlv，90% 是因为容器没暴露调试端口、dlv 没启用 headless 模式，或用了 --api-version=2 但 GoLand 版本不匹配。
- 容器内启动命令必须为：
dlv --headless --listen=:2345 --api-version=2 --accept-multiclient exec ./myapp（注意--headless和--accept-multiclient缺一不可） - Docker run 需加
-p 2345:2345，且镜像内防火墙（如 Alpine 的iptables）不能拦截该端口 - GoLand 新建 Remote Debug 配置时，Host 填容器宿主机 IP（非
localhost），Port 填2345，并勾选Allow connections from network hosts - 若用 Kubernetes，Service 类型需为
NodePort或LoadBalancer，且 Pod 的securityContext要允许ptrace（如capabilities: {add: [SYS_PTRACE]}）
dlv 版本、编译标志、容器网络策略、IDE 工具路径配置，任一环节差一点，断点就只是个灰色圆点。 
