用testing.B做基准测试是Go原生支持的性能测试方式,函数名须为BenchmarkXXX,b.N由框架动态调整以确保总耗时足够,需用benchstat对比结果并控制测试环境一致性。

用 testing.B 做基准测试是最直接的方式
Go 原生支持性能测试,不是靠 time.Now() 手动打点——那是单元测试或调试用的。真正衡量函数吞吐、稳定性和可比性,必须用 testing.B 类型的基准测试函数,它会自动多次运行并排除启动开销。
关键点:
- 函数名必须是
BenchmarkXXX,且参数为*testing.B -
b.N是框架控制的循环次数,不要硬编码for i := 0; i - 耗时统计由
testing包自动完成,你只需确保被测逻辑在b.ResetTimer()后执行(如有初始化开销) - 避免在循环内做 I/O、分配大对象或调用非确定性函数(如
rand.Int()),否则结果不可靠
func BenchmarkAdd(b *testing.B) {
a, bVal := 1, 2
b.ResetTimer() // 排除变量声明开销
for i := 0; i < b.N; i++ {
_ = add(a, bVal)
}
}
go test -bench 的常用参数组合决定你能看到什么
不加参数跑 go test -bench=. 只给个粗略的 ns/op,但实际排查性能瓶颈需要更多上下文。
推荐组合:
立即学习“go语言免费学习笔记(深入)”;
-
go test -bench=. -benchmem:同时显示内存分配次数(allocs/op)和字节数(B/op),对识别逃逸、冗余拷贝很关键 -
go test -bench=. -benchtime=5s:让每项基准至少跑够 5 秒,提升统计稳定性(默认是 1 秒) -
go test -bench=BenchmarkAdd$:用正则精确匹配单个函数,避免误跑其他 benchmark -
go test -bench=. -cpuprofile=cpu.out && go tool pprof cpu.out:生成 CPU 采样,定位热点函数
别在 Benchmark 函数里用 fmt.Println 或 log
输出语句会严重干扰计时——它们本身就有 I/O 开销,而且可能触发锁、调度切换甚至 GC。即使只调用一次,也会让 b.N 的迭代节奏失真。
正确做法:
- 调试阶段先写普通
TestXXX验证逻辑,再迁移到BenchmarkXXX - 如果真要观察中间值,用
b.ReportMetric()上报自定义指标(Go 1.21+),而不是打印 - 想看每次迭代结果?不行。基准测试的目标是测量「稳态性能」,不是单次行为
对比多个实现时,用 benchstat 算相对差异
单纯看两行 ns/op 数字很难判断是否真的变快了——尤其当差异在 5% 以内时,可能是噪声。官方工具链没内置统计显著性检验,得靠外部工具。
操作步骤:
- 分别运行两个版本的基准测试,保存结果到文件:
go test -bench=. -benchmem > old.txt和> new.txt - 安装
benchstat:go install golang.org/x/perf/cmd/benchstat@latest - 执行对比:
benchstat old.txt new.txt,它会给出中位数变化率 + 置信区间
注意:两次测试尽量在相同机器、关闭无关进程、禁用 CPU 频率调节(如 sudo cpupower frequency-set -g performance),否则数据不可比。
最常被忽略的一点:b.N 不是固定值,它由前几次预热运行动态调整,以保证总耗时足够长;这意味着不同机器、不同 Go 版本下,同一份 benchmark 的 b.N 可能差几倍——所以永远别在代码里假设 b.N == 1000000。











