本文介绍如何使用 go 标准库的 `testing.benchmark` 函数主动执行基准测试，获取 `testing.benchmarkresult` 实例，并将其结构化输出到文件，从而脱离默认控制台打印，实现结果的自动化收集与分析。
Go 的 testing 包不仅支持通过 go test -bench 命令行方式运行基准测试，还提供了程序化接口——testing.Benchmark(func(*testing.B))，可直接在普通 main 包中调用，返回一个完整的 testing.BenchmarkResult 结构体。该结构体包含关键性能指标：N（执行次数）、T（总耗时，单位纳秒）、Bytes（每操作处理字节数）、MemAllocs（内存分配次数）和 MemBytes（总内存分配字节数），便于后续解析、比较或存档。
以下是一个完整示例，演示如何定义被测函数、编写基准逻辑、捕获结果并写入 JSON 文件：
package main
import (
"encoding/json"
"fmt"
"os"
"testing"
"time"
)
func Add(a, b int) int {
time.Sleep(10 * time.Microsecond) // 模拟轻量计算开销
return a + b
}
func BenchAdd(b *testing.B) {
for i := 0; i < b.N; i++ {
_ = Add(1, 2)
}
}
func main() {
// 主动运行基准测试，获取结构化结果
result := testing.Benchmark(BenchAdd)
// 打印简明摘要（与 go test -bench 输出格式一致）
fmt.Printf("%8d\t%8.0f ns/op\n", result.N, float64(result.T)/float64(result.N))
// 序列化为 JSON 并写入文件
data, err := json.MarshalIndent(result, "", " ")
if err != nil {
panic(fmt.Sprintf("JSON marshal failed: %v", err))
}
if err := os.WriteFile("benchmark_result.json", data, 0644); err != nil {
panic(fmt.Sprintf("Failed to write file: %v", err))
}
fmt.Println("✅ Benchmark result saved to benchmark_result.json")
}运行该程序后，控制台将输出类似 120000 10000 ns/op 的标准格式摘要，同时生成 benchmark_result.json 文件，内容如下：
{
"N": 120000,
"T": 1200000000,
"Bytes": 0,
"MemAllocs": 0,
"MemBytes": 0,
"Extra": {}
}⚠️ 注意事项：
- testing.Benchmark 只能在非测试包（如 main 包）中安全调用；不可在 _test.go 文件中使用，否则可能触发 testing 包内部状态冲突。
- 该方式绕过了 go test 的基准预热、多次采样及统计（如 min, mean, stddev），仅执行单次基准循环。如需严谨统计，建议结合 go test -benchmem -benchtime=5s -count=3 等参数，再通过 -json 输出解析（Go 1.21+ 支持 go test -json 流式基准事件）。
- 若需扩展指标（如自定义内存/延迟观测），可利用 result.Extra 字段（类型为 map[string]float64），在 BenchAdd 内通过 b.ReportMetric(value, "unit") 注入（Go 1.20+ 引入）。
综上，testing.Benchmark 是实现基准测试结果程序化采集的轻量级方案，适用于 CI 脚本集成、性能回归快照或简单横向对比场景。对于生产级性能监控，推荐搭配 go test -json 与专用解析工具链使用。
