Delve 提供了专用的 dlv test 命令，可直接调试 Go 单元测试，无需手动编译测试二进制文件，避免“cannot debug non-main package”错误，并自动清理临时文件。
delve 提供了专用的 `dlv test` 命令，可直接调试 go 单元测试，无需手动编译测试二进制文件，避免“cannot debug non-main package”错误，并自动清理临时文件。
在 Go 开发中，使用 go test 运行单元测试非常便捷，但当测试逻辑复杂或行为异常时，仅靠日志和断言难以定位问题。此时，交互式调试至关重要。然而，直接对非 main 包执行 dlv exec 会触发 "Can not debug non-main package" 错误——因为 Delve 默认要求可执行入口（即 main 函数），而普通测试包不具备该结构。
正确做法是使用 Delve 内置的测试调试模式：
dlv test -- -test.v
该命令会自动调用 go test -c 编译当前包的测试二进制（内部生成临时 .test 文件并立即加载调试），随后启动调试会话。-- 之后的参数将透传给 go test，因此支持所有标准测试标志，例如：
-
-test.run ^TestReadFile$：仅运行TestReadFile -
-test.v：启用详细输出 -
-test.count=2：重复运行测试两次 -
-test.timeout=30s：设置超时
你还可以在调试会话中设置断点、单步执行、检查变量：
(dlv) break mypackage.TestReadFile Breakpoint 1 set at 0x49a8f0 for mypackage.TestReadFile() ./readfile_test.go:12 (dlv) continue === RUN TestReadFile (dlv) locals f = *os.File nil err = error "open missing.txt: no such file or directory"
⚠️ 注意事项：
- 确保已安装 Delve（
go install github.com/go-delve/delve/cmd/dlv@latest）； - 调试时工作目录需为待测包根目录（即包含
_test.go文件的目录）； - 若项目启用了 Go Modules，请确保
GO111MODULE=on（默认已启用）； -
dlv test不支持远程调试（如--headless+--api-version=2组合用于 IDE 连接），如需 IDE 集成，请改用dlv exec <pkg>.test -- -test.*</pkg>并手动管理二进制生命周期。
总结：dlv test 是调试 Go 单元测试的官方推荐方式——简洁、安全、无残留。它抽象了底层编译细节，让开发者专注逻辑排查，是提升测试开发效率的关键工具。
