本文介绍如何使用 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 <p>运行该程序后，控制台将输出类似 120000 10000 ns/op 的标准格式摘要，同时生成 benchmark_result.<a style="color:#f60; text-decoration:underline;" title="js" href="https://m.php.cn/zt/15802.html" target="_blank">js</a>on 文件，内容如下：</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill12671" title="JSON Toolkit"><img
src="https://img.php.cn/upload/skill/000/000/081/179449024567181.jpg" alt="JSON Toolkit" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill12671" title="JSON Toolkit" class="overflowclass">JSON Toolkit</a>
<p class="overflowclass">JSON文件多功能工具。支持格式化、验证、压缩、键排序及点记法路径查询。零依赖。</p>
</div>
<a rel="nofollow" href="/xiazai/skill12671" title="JSON Toolkit" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div><pre class="brush:php;toolbar:false;">{
"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 与专用解析工具链使用。
