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 .test -- -test.* 并手动管理二进制生命周期。

总结：dlv test 是调试 Go 单元测试的官方推荐方式——简洁、安全、无残留。它抽象了底层编译细节，让开发者专注逻辑排查，是提升测试开发效率的关键工具。