调试Go测试必须用dlv test而非dlv debug,因测试代码编译为独立_test二进制;需加-gcflags="-N -l"禁用优化,断点须用完整包路径如myproj/pkg.TestFoo。

dlv debug 只能调试 main 包,不能进测试函数——这是最常卡住的第一步。想调试测试,必须用 dlv test,不是 go test 加个 dlv attach 就能搞定。
dlv test 是调试 Go 测试的唯一入口
你写了 func TestFoo(t *testing.T),加了断点,执行 dlv debug 却完全不触发?因为测试代码被编译进独立的 *_test 二进制,和 main 包无关。dlv debug 根本不会加载它。
-
dlv test:启动当前包所有测试,进入 Delve REPL 后再手动设断点、运行 -
dlv test -- -test.run ^TestFoo$:只构建并运行单个测试,推荐日常使用(注意--分隔符不能漏) - 必须在含
go.mod的包根目录下执行,否则报no Go files in directory - 如果项目有多个子模块,确保当前目录是待测包路径,不是项目根目录或
cmd/下
断点必须写完整包路径,比如 break myproj/pkg.TestFoo
Delve 不识别裸函数名。你在 pkg/foo_test.go 里写的 TestFoo,实际全名是 myproj/pkg.TestFoo(取决于 go.mod 模块名和目录结构)。
- 查包名最快方式:
go list -f '{{.ImportPath}}' ./pkg - 设断点时别写
break TestFoo或break pkg.TestFoo,缺模块前缀就悬空 - 函数内断点可用行号,如
break pkg/foo_test.go:42,但首次仍建议用全名确保命中 - 如果用 VS Code,在
launch.json中设断点后,启动前看调试控制台是否打印Breakpoint 1 set at …,没这句说明路径错
变量显示 ?必须加 -gcflags="-N -l"
这不是 Delve 的问题,是 Go 编译器默认做了内联和寄存器优化,把变量从栈帧里“删”了。Delve 没法读取不存在的东西。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 命令行调试:所有
dlv命令后追加-gcflags="-N -l",例如dlv test -gcflags="-N -l" -- -test.run ^TestFoo$ - VS Code:
launch.json的args字段里加两项:"-gcflags"和"-N -l"(顺序不能反) -
-N禁用优化,-l忽略内联——两个都得有,缺一不可 - 加了之后二进制稍大、运行略慢,但这是调试阶段的必要代价;上线构建时再去掉
VS Code 中 program 字段填的是包路径,不是文件路径
很多人把 "program": "./main.go" 或 "program": "." 当成“指定入口文件”,结果断点全悬空,控制台只报模糊错误如 could not launch process: stub exited while waiting for connection。
- 单模块项目,
main.go在根目录:"program": "${workspaceFolder}" - 多模块,
main在cmd/myapp:"program": "${workspaceFolder}/cmd/myapp" - 调试测试:
"mode": "test"且"program": "${workspaceFolder}/pkg"(仍是包路径,不是foo_test.go文件) - 填错会导致 Delve 构建一个空包,连
init()都不跑,断点自然无效
真正容易被忽略的,是 -gcflags="-N -l" 这个参数——它不报错,但会让你以为 Delve 坏了;还有 dlv test 和 dlv debug 的语义差异,一旦混用,整个调试流程就卡死在第一步。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










