用途:为 Go 项目提供完整的性能度量工作流——编写基准测试、运行、剖析结果、以统计严谨的方式对比优化前后,并在 CI 中跟踪性能回归。前提是任何优化决策都必须基于多次运行与受控条件,不凭单次结果下结论。
主要能力:
- 编写基准测试。基准函数放在与源文件同名的 _bench_test.go 中(如 parser.go 对应 parser_bench_test.go),函数顺序与被测函数在源文件中的顺序一致。Go 1.24+ 推荐 b.Loop(),只计时循环体并保持参数/结果存活,减少死代码消除问题;旧式 b.N 循环仍可用,但需注意 b.ResetTimer() 与结果 sink。用 b.ReportAllocs() 或 -benchmem 跟踪内存,b.ReportMetric() 添加自定义指标,b.Run() 实现子基准与表驱动。
- 运行基准。常用命令:go test -bench=BenchmarkEncode -benchmem -count=10 ./pkg/... | tee bench.txt。可用 -benchtime、-cpu、-cpuprofile、-memprofile、-trace 等标志;输出含 ns/op、B/op、allocs/op 与 GOMAXPROCS 后缀。
- 并行验证多个优化方案。每个方案在独立 worktree 中用子智能体实现,但基准必须串行运行,避免共享 CPU 的噪声污染。以同一基线报告对比各方案的 benchstat 输出,保留最优者。
- 在提交中记录结果。用 perf(scope): 提交类型,粘贴 benchstat 输出,只保留受影响的基准行,不得粘贴带 ~(无统计显著性)的结果,并附上 goos/goarch/cpu 等硬件上下文。
- 从基准生成 pprof 剖析:go test -bench=... -cpuprofile=cpu.prof 后用 go tool pprof 分析;-memprofile 区分 alloc_objects(GC 抖动)与 inuse_space(泄漏);-trace 生成执行轨迹。
依赖:benchstat,安装命令 go install golang.org/x/perf/cmd/benchstat@latest。
适用场景:Go 代码性能测量、优化前后对比、pprof 热点分析、CI 性能回归门禁、生产性能问题排查。
限制与注意:Go 1.27 的尺寸特化分配器会改变分配密集基准的基线,跨 1.26→1.27 工具链的对比衡量的是工具链而非代码,需在同一工具链重跑 before。b.Elapsed() 仅在 b.Loop() 内有效。具体优化模式、运行中服务的 pprof 配置、可观测性方案等需参考相关配套技能。本文档未提供收费、价格或平台信息。