Go / 系统课时
编写 Go 基准测试
编写 Go 基准测试
Go 基准测试用 testing.B 驱动同一段代码反复执行,并由测试框架自动决定迭代次数。本节会写出一个可由 go test -bench 运行的最小基准,读懂 ns/op、内存分配等结果,并避开最常见的测量失真。
学习目标
- 理解
BenchmarkXxx、testing.B与b.N的执行关系。 - 编写可直接运行的 Go 基准函数,并用
go test -bench选择它。 - 根据
ns/op、B/op和allocs/op判断一次基准实际测量了什么。
基准测试如何被驱动
Go 会识别形如 func BenchmarkXxx(b *testing.B) 的函数。运行基准时,框架会校准 b.N,让被测循环执行足够多次,因此代码不能假设固定迭代次数,也不要把一次性的准备工作放进 b.N 循环。
一个基准函数最重要的约束,是循环体只保留真正想测的操作。b.N 不是业务参数,而是测试框架给出的迭代次数;框架可能用不同的 b.N 多次调用基准函数,最终汇总为每次操作的平均成本。
编写最小可运行基准
在任意已初始化的 Go module 中创建 sum_test.go。下面的基准先构造固定输入,再用 b.ResetTimer() 清除准备阶段已经消耗的计时,循环中只测 sum。包级 sink 让结果在基准结束后仍被观察,避免编译器把无用计算直接消除。
package benchdemo
import "testing"
var sink int
func sum(values []int) int {
total := 0
for _, value := range values {
total += value
}
return total
}
func BenchmarkSum(b *testing.B) {
values := []int{1, 2, 3, 4, 5, 6, 7, 8}
b.ResetTimer()
result := 0
for i := 0; i < b.N; i++ {
result = sum(values)
}
sink = result
}运行时用 -run '^$' 跳过普通测试,用 -bench 精确选择基准;-benchmem 同时报告分配数据。这里固定执行 100 次,便于观察命令是否正确,真实性能比较通常应让框架自行校准或重复多次运行。
go test -run '^$' -bench '^BenchmarkSum$' -benchmem -benchtime=100x预期输出
goos: <OS>
goarch: <ARCH>
pkg: <MODULE_PATH>
cpu: <CPU>
BenchmarkSum-<PROCS> 100 <NS_PER_OP> ns/op 0 B/op 0 allocs/op
PASS
ok <MODULE_PATH> <TIME><OS>、<CPU>、<PROCS>、<MODULE_PATH>、<NS_PER_OP> 和 <TIME> 会随运行环境变化;关键是出现 BenchmarkSum、迭代次数 100,并得到每次操作的时间与分配指标。
读懂一行基准结果
ns/op 表示平均每次循环操作耗费的纳秒数,越小通常越快;B/op 表示平均每次操作产生的堆分配字节数;allocs/op 表示平均分配次数。只有在输入、机器、Go 版本和运行条件近似一致时,这些数字才适合直接比较。
不要把一次运行的微小差异当成优化结论。CPU 调频、后台进程、垃圾回收和调度都会带来噪声。性能决策更适合比较多次结果的分布,并关注差异是否稳定且具有实际量级,而不是只看最后几位小数。
避免基准代码本身污染结果
循环里不要打印日志、随机生成测试数据或做与目标无关的断言,这些操作都会被计入 ns/op。如果被测函数返回值完全未使用,编译器还可能消除一部分工作,因此常用包级变量保存最后结果,或者让结果参与后续可观察行为。
基准测试的价值不在于得到一个“绝对速度”,而在于建立可重复的比较条件。只要被测操作、输入规模和环境约束稳定,同一基准就能用于比较优化前后、实现 A 与实现 B,或监控后续代码变更是否引入明显性能回退。