基准测试函数必须以Benchmark开头且接收*testing.B参数;常见错误包括参数类型错误、前缀小写、漏调b.ResetTimer()或在循环外初始化,b.N由框架自动调整。
基准测试函数必须以 Benchmark 开头且接收 *testing.B
Go 的基准测试不是随便起个函数名就能跑的,必须严格满足两个条件:函数名以 Benchmark 为前缀(如 BenchmarkMapAccess),且唯一参数类型是 *testing.B。否则 go test -bench 会直接忽略它。
常见错误包括:
- 写成
func BenchmarkMapAccess(t *testing.T)—— 参数类型错,会被当成普通测试,-bench不识别 - 写成
func benchMapAccess(b *testing.B)—— 前缀小写,不被发现 - 漏掉
b.ResetTimer()或在b.N循环外做了初始化操作,导致初始化开销混入测量结果
b.N 是自动调整的迭代次数,别手动写死循环
Go 基准测试会先预热,再根据目标耗时(默认 1 秒)动态调整 b.N 值,让总执行时间稳定可比。你只需在 b.ResetTimer() 后用 for i := 0; i 包裹待测逻辑。
错误做法:
- 写
for i := 0; i —— 失去自动调优能力,不同机器/函数间不可比 - 在
for循环里调用b.ReportAllocs()或b.SetBytes()—— 应放在循环外一次性设置 - 忘记调用
b.ReportAllocs()就想看内存分配,结果allocs/op显示为0
避免在基准测试中触发 GC 或阻塞操作
任何非目标逻辑的额外开销都会污染结果。比如在循环里反复 make([]int, n)、fmt.Sprintf、或调用 time.Sleep,不仅放大内存分配,还可能让 runtime 插入 GC,导致 ns/op 波动极大甚至失真。
实操建议: