go test -bench 是运行go基准测试的基本命令,需在_test.go文件中定义以benchmark开头、接收testing.b参数的函数,必须用go test -bench=.(匹配所有)或-go test -bench=benchmarkadd(指定函数)执行,并建议始终加上-benchmem以报告内存分配。
go test -bench 运行基准测试的基本命令
Go 基准测试必须写在 *_test.go 文件中,函数名以 Benchmark 开头、接收 *testing.B 参数。运行时不能用 go run,必须用 go test 配合 -bench 标志。
最常用命令是:
go test -bench=.
其中 . 表示匹配所有 Benchmark 函数;若只想跑某个,比如 BenchmarkAdd,就写 -bench=BenchmarkAdd(支持正则,如 -bench=^BenchmarkAdd$ 更精确)。
- 默认只运行 1 轮预热,真正计时前会自动调整执行次数(
b.N),直到总耗时稳定 - 不加
-benchmem时不会报告内存分配,建议始终加上 - 如果包里没有
Benchmark函数,命令会静默退出,不报错也不输出
为什么 benchmark 不生效:常见被忽略的条件
即使函数签名正确,go test -bench 也可能“没反应”或结果为 0 B/op —— 多数是因为没在 BenchmarkXxx 函数体内调用 b.N 控制循环。
错误写法(死循环、不依赖 b.N):
func BenchmarkBad(t *testing.B) {
for i := 0; i < 1000; i++ { // ❌ 固定次数,不随 b.N 变化
doWork()
}
}
正确写法(必须用 b.N):