Go语言的标准测试框架自带基准测试功能,开发者可以通过编写基准测试函数来验证代码的性能表现,不需要额外引入第三方库。基准测试函数需要遵循特定的命名规则,才能被go test命令识别并执行。

Go基准测试的基础运行方式
首先我们需要了解基准测试函数的基本写法,基准测试函数的函数名必须以Benchmark开头,并且接收一个*testing.B类型的参数,函数需要放在_test.go后缀的文件中,和普通的单元测试文件放在一起即可。
下面是一个简单的基准测试示例,用于测试字符串拼接的性能:
package main
import (
"strings"
"testing"
)
// 基准测试函数,测试strings.Builder拼接字符串的性能
func BenchmarkStringBuilder(b *testing.B) {
// 重置计时器,排除准备阶段的耗时
b.ResetTimer()
// 循环b.N次,b.N的值会由框架自动调整,保证测试时长足够
for i := 0; i < b.N; i++ {
var builder strings.Builder
builder.WriteString("hello")
builder.WriteString(" ")
builder.WriteString("world")
_ = builder.String()
}
}
要运行这个基准测试,只需要在对应目录下执行go test -bench=.命令即可,其中-bench参数用来指定要运行的基准测试函数匹配规则,.表示匹配所有基准测试函数。
go test bench常用参数解析
除了基础的-bench参数,go test还提供了很多和基准测试相关的参数,我们可以根据实际需求选择使用。
1. -bench参数
该参数用来指定要运行的基准测试函数,支持正则表达式匹配。比如只想运行BenchmarkStringBuilder函数,可以执行go test -bench=BenchmarkStringBuilder;如果想运行所有以BenchmarkString开头的基准测试,可以执行go test -bench=BenchmarkString。
2. -benchtime参数
该参数用来指定每个基准测试函数的最短运行时间,默认值是1秒。比如想让每个基准测试至少运行3秒,可以执行go test -bench=. -benchtime=3s。也可以指定固定的迭代次数,比如-benchtime=1000x表示每个基准测试固定迭代1000次。
3. -count参数
该参数用来指定每个基准测试函数运行的次数,默认值是1。比如想让每个基准测试运行3次,取平均结果,可以执行go test -bench=. -count=3。多次运行可以减少偶然因素对测试结果的影响。
4. -benchmem参数
该参数用来在基准测试结果中输出内存分配相关的统计信息,包括每次操作的内存分配字节数和分配次数。执行go test -bench=. -benchmem后,输出结果会多出两列,分别是B/op和allocs/op,分别表示每次操作分配的字节数和分配次数。
下面是加上-benchmem参数后的输出示例:
goos: linux goarch: amd64 pkg: example/benchmark cpu: Intel(R) Core(TM) i7-10700 CPU @ 2.90GHz BenchmarkStringBuilder-8 1000000 1052 ns/op 48 B/op 2 allocs/op PASS ok example/benchmark 1.172s
5. -cpu参数
该参数用来指定基准测试使用的CPU核心数,支持传入多个值,用逗号分隔。比如想测试代码在1核、2核、4核下的性能表现,可以执行go test -bench=. -cpu=1,2,4,框架会针对每个CPU核心数分别运行一次基准测试。
基准测试的注意事项
在编写和运行基准测试时,有几个需要注意的点:
- 基准测试函数中的准备代码(比如变量初始化)应该放在
b.ResetTimer()之前,避免准备阶段的耗时影响测试结果。 - 如果基准测试中有耗时的操作不需要计入测试,可以使用
b.StopTimer()暂停计时,操作完成后再用b.StartTimer()恢复计时。 - 基准测试的结果会受到当前机器负载、其他运行程序的影响,所以尽量在环境稳定的情况下运行测试,多次运行取稳定结果。
下面是一个使用StopTimer和StartTimer的示例:
func BenchmarkWithPrepare(b *testing.B) {
b.StopTimer() // 暂停计时
// 这里是需要准备但不需要计入测试耗时的操作
data := make([]int, 10000)
for i := range data {
data[i] = i
}
b.StartTimer() // 恢复计时
for i := 0; i < b.N; i++ {
_ = data[0]
}
}
Gogo_test_bench基准测试性能测试修改时间:2026-07-08 16:30:30