Go 单元测试调试需让失败现场“停下来”：用 -test.run 和 -test.v 精准定位并显示日志；用 Delve 设置断点、查看变量、单步执行；用 t.Helper() 和结构化 t.Errorf 提升错误可读性；通过 mock 和可替换依赖（如 nowFunc）控制外部行为。
Go 的单元测试失败时，直接看 panic 信息或日志往往不够直观。调试的关键是让失败现场“停下来”，看清变量值、执行路径和依赖行为。下面是一些实用、可立即上手的调试技巧。
用 -test.run 和 -test.v 精准定位失败用例
当一个测试文件里有多个 TestXxx 函数，而只有一两个失败时，先缩小范围：
- -test.run=TestName：只运行匹配的测试函数，避免干扰
- -test.v：开启详细输出，显示每个 t.Log() 和测试开始/结束信息
- 组合使用：
go test -test.run=TestParseJSON -test.v
如果测试中用了 t.Log 或 fmt.Println，-test.v 能确保这些输出不被吞掉，方便观察中间状态。
在测试中加断点并用 Delve 调试
Go 原生不支持 IDE 断点式调试测试，但 Delve 完全支持：
立即学习“go语言免费学习笔记（深入）”；
- 安装：
go install github.com/go-delve/delve/cmd/dlv@latest - 启动调试：
dlv test -- -test.run=TestFetchData - 进入 dlv 交互后，用
b main.TestFetchData下断点，再c运行 - 支持
p variable查看变量、n单步、goroutines查协程状态
特别适合排查竞态、空指针、接口断言失败等 runtime panic 场景。
用 t.Helper() + t.Errorf 配合结构化错误提示
默认的 t.Errorf("got %v, want %v", got, want) 在嵌套调用中难以定位问题源头。改进方式：
- 自定义校验函数标记为
t.Helper()，让错误行号指向调用处而非内部 - 在失败时打印上下文：比如请求参数、时间戳、依赖返回值
- 示例：
func assertEqual(t *testing.T, got, want interface{}) {
t.Helper()
if !reflect.DeepEqual(got, want) {
t.Errorf("assertion failed at %s:\n\tgot: %+v\n\twant: %+v",
debug.GetCaller(1), got, want)
}
}模拟依赖并观察调用过程
测试失败常因外部依赖（HTTP、DB、时间）行为不符合预期。不要跳过 mock，而是让 mock “说话”：
- 用 testify/mock 或 gomock 生成 mock，并启用
mock.AssertExpectations(t) - 在 mock 方法里加 t.Log 记录入参和返回时机
- 对 time.Now() 这类全局函数，注入可替换的 timeFunc 变量，测试中固定返回特定时间
例如：var nowFunc = time.Now，测试时设为 nowFunc = func() time.Time { return time.Date(2024, 1, 1, 0, 0, 0, 0, time.UTC) }。
基本上就这些。不需要复杂工具链，从 -test.v 开始，配合 dlv 和带上下文的断言，90% 的测试失败都能快速定位。关键是让“失败”变成“可读、可停、可问”的过程。
