Benchmark函数需严格遵循命名、参数、文件名规范,初始化在b.ResetTimer()前,被测逻辑禁用I/O和随机操作,结果必须被使用,用benchstat分析差异并排除环境噪声。

怎么写一个能比的 Benchmark 函数
基准测试不是写个循环跑几次就完事,关键是要让两个函数测的是“同一回事”。比如对比 map 查找和切片遍历,输入数据必须完全一样:同一批 key、同样长度、相同分布,否则结果毫无可比性。
- 函数名必须以
Benchmark开头,参数类型必须是*testing.B,文件名必须是*_test.go—— 写错任意一项,go test -bench=.就会静默跳过,不报错也不提示 - 所有初始化(造数据、建结构体、预热)必须放在
b.ResetTimer()之前;计时只从这行之后开始 - 每次循环里只能放被测逻辑,禁止调用
fmt.Println、time.Now()、rand.Intn()—— 它们引入噪声,还可能被编译器优化掉整段循环 - 结果必须“被使用”,哪怕只是
_ = result或赋给局部变量再丢弃;Go 1.21+ 编译器看到没副作用的计算,真会直接删掉
示例中常见错误:for i := 0; i —— 这测的是 <code>make + 插入,不是你想要的“访问性能”。
运行命令不能只敲 go test -bench=.
默认命令跑出来的数字抖动大、不可信,尤其在 CI 或笔记本上。单次运行受 CPU 频率、后台进程、GC 暂停干扰严重,容易误判快慢。
- 加
-count=5:强制跑 5 轮,go test自动取中位数,过滤异常值 - 加
-benchtime=5s:每轮至少跑满 5 秒,避免因太快导致采样不准(比如默认 1 秒内只跑了 10 万次,误差可能 ±15%) - 加
-benchmem:必须开,光看ns/op是危险的 —— 一个函数快 20%,但allocs/op高出 5 倍,高频调用下 GC 压力会直接拖垮服务 - 加
GOMAXPROCS=1环境变量:排除 goroutine 调度干扰,纯看算法/内存行为差异
推荐组合:GOMAXPROCS=1 go test -bench=. -benchmem -count=5 -benchtime=5s。少一个参数,都可能让结论翻车。
立即学习“go语言免费学习笔记(深入)”;
怎么对比两版代码的差异才算靠谱
人眼对比 “1240 ns/op vs 1190 ns/op” 是无效的。3% 的差距在单次运行里完全可能是噪音;真正要判断“有没有变快”,得靠统计检验。
- 别用已废弃的
benchcmp,它只算均值比,没做显著性分析 - 用
benchstat:Go 1.21+ 默认自带,旧版本需go install golang.org/x/perf/cmd/benchstat@latest - 两组数据必须用**完全一致的参数**生成:
go test -bench=BenchmarkFoo -count=5 -benchmem -benchtime=5s > old.txt,改完再跑一遍存成new.txt -
benchstat old.txt new.txt输出里,-8.23%表示新版本快了约 8%,p=0.003表示差异显著;如果标准差 >5% 或p > 0.05,说明环境不稳或改动没效果
注意:benchstat 不会帮你过滤噪声 —— 如果你边压测边编译、开着 Chrome、或者没关 Spotlight,它照样分析,然后给你一个“看似显著实则虚假”的结论。
哪些坑会让 benchmark 结果彻底失真
最危险的不是测不准,而是测得“太准”—— 准到反常识,比如 BenchmarkFoo-8 1000000000 0.32 ns/op。这通常意味着编译器把整个循环优化掉了。
-
blackhole技巧:把关键中间值赋给包级变量(如var result int),或用testing.BenchmarkResult辅助验证是否逃逸 - 避免全局变量读写:并发运行多个
Benchmark时,共享map或slice会触发竞争,且无法反映单次调用开销 - 别测 I/O、网络、文件操作:这些依赖系统状态,
go test -bench不适合压测真实服务 —— 想看 QPS 请用ghz;这里只适合测json.Unmarshal、strings.Builder这类纯内存逻辑 - 结构体传值还是传指针?别猜,用
go test -gcflags="-m"看逃逸分析,再用Benchmark实测 —— 临界点在 64–128 字节之间,但具体取决于字段排列和 Go 版本
复杂点在于:你控制得了代码,但控制不了环境。一次可靠的对比,一半功夫花在关掉无关进程、固定 CPU 频率、确认 GC 未在采样中触发 —— 这些细节不显眼,却决定结论能不能站住脚。



















