go单元测试必须用*testing.t参数、test开头命名、同包_test.go文件;需t.parallel()确保并发安全,表驱动测试应带语义化name字段,bench需关注b.n稳定性和-benchmem指标。

Go 的测试不是“要不要做”的问题,而是“怎么写才不白写、不返工、不漏测”的问题。标准 testing 包足够用,但直接照搬示例容易掉进断言冗余、子测试混乱、性能误判的坑里。
TestXxx 函数必须接收 *testing.T,且不能省略 t.Parallel()
很多新手写完第一个 TestAdd 就以为会了,结果在 CI 里跑出随机失败——原因往往是没处理并发安全。Go 默认串行执行测试,但一旦你显式调用 t.Parallel(),就必须确保:
- 被测函数和所有依赖(比如全局变量、临时文件路径、内存缓存)不共享状态
- 同一包内多个 TestXxx 函数之间没有隐式时序依赖
- 如果用了 t.Run 嵌套子测试,每个子测试里都要单独调用 t.Parallel(),否则只外层并行,内层仍阻塞
表驱动测试别只写输入输出,要带上下文命名
光写 []struct{a,b,want int} 是最低效的表驱动。真正省维护成本的是带语义的字段名和 t.Run 标签:
func TestDivide(t *testing.T) {
tests := []struct {
name string
a, b int
want int
err bool
}{
{"positive_division", 10, 2, 5, false},
{"zero_divisor", 10, 0, 0, true},
{"negative_dividend", -10, 3, -3, false}, // Go 整除向零截断
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := Divide(tt.a, tt.b)
if (err != nil) != tt.err {
t.Fatalf("unexpected error state: %v, want %v", err, tt.err)
}
if got != tt.want {
t.Errorf("got %d, want %d", got, tt.want)
}
})
}
}
这样失败时输出是 TestDivide/positive_division,而不是一堆 TestDivide/0,排查效率差一个数量级。
初始化并管理阿里云SDK Go 客户端,涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
go test -bench=. 不等于性能真实值,必须看 b.N 和内存分配
运行 go test -bench=. 看到 BenchmarkAdd-8 1000000000 0.32 ns/op 就觉得快?危险。关键要看三件事:
-
b.N是否稳定:如果每次运行b.N差异超过 20%,说明有外部干扰(GC、系统负载),结果不可信 - 是否漏掉内存分配:加
-benchmem,比如2 B/op 0 allocs/op才算零拷贝;若显示16 B/op,就得查是不是无意中触发了字符串转字节切片 - 基准函数里不能有可变逻辑:比如
for i := 0; i —— 这会让 CPU 分支预测失效,测的不是函数本身,是预测准确率
测试文件里 import "testing" 就够了,别碰 testify/mock
90% 的业务逻辑根本不需要第三方断言库。标准 t.Errorf + 表驱动已经覆盖全部需求。引入 testify 或 gomock 的唯一合理场景是:
- 你要 mock 数据库连接、HTTP 客户端、时间依赖等**跨进程边界**的调用
- 且被测代码已按依赖倒置原则拆出了 interface(比如 type DB interface { Query(...) })
- 否则直接在测试里 new 一个内存 map 模拟缓存,或用 io.NopCloser 包裹字符串模拟响应体,更轻、更快、无额外学习成本
最常被忽略的一点:go test 默认不编译测试文件里的未使用变量和函数。如果你在 _test.go 里写了辅助函数但没调用,它根本不会报错,也不会出现在覆盖率里——这种“幽灵测试”比没写还危险。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










