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 让结果在基准结束后仍被观察,避免编译器把无用计算直接消除。

go
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 次,便于观察命令是否正确,真实性能比较通常应让框架自行校准或重复多次运行。

bash
go test -run '^$' -bench '^BenchmarkSum$' -benchmem -benchtime=100x

预期输出

text
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,或监控后续代码变更是否引入明显性能回退。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

编写 Go 基准测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通