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 控制循环。
立即学习“go语言免费学习笔记（深入）”；
错误写法（死循环、不依赖 b.N）：
func BenchmarkBad(t *testing.B) {
for i := 0; i < 1000; i++ { // ❌ 固定次数，不随 b.N 变化
doWork()
}
}正确写法（必须用 b.N）：
func BenchmarkGood(b *testing.B) {
for i := 0; i < b.N; i++ { // ✅ b.N 由测试框架动态设定
doWork()
}
}-
b.ResetTimer()可在 setup 后重置计时器（比如初始化数据耗时长，但不属于待测逻辑） -
b.ReportAllocs()和-benchmem效果一致，但后者更常用 - 忘记
go:build约束或文件名不含_test.go，会导致测试文件根本未被编译
控制性能测试精度与资源：-benchtime、-count、-cpu
默认单次运行约 1 秒，但实际耗时受机器负载、GC 干扰影响。需要更高置信度时，得手动调参。
-
-benchtime=5s：让每组 benchmark 至少运行 5 秒（不是只跑 5 秒，而是累计达到该时长） -
-count=3：重复整个 benchmark 流程 3 次，输出三组结果（可用于观察波动） -
-cpu=2,4：分别在 2 和 4 个 GOMAXPROCS 下运行，检验并发敏感性 -
-benchmem必须显式加，否则allocs/op和B/op全为 0
组合示例：
go test -bench=^BenchmarkMapAccess$ -benchmem -benchtime=3s -count=5
对比多个实现：用 benchstat 分析差异
单独一次 go test -bench 输出只是原始数据，看不出是否真有性能提升。Go 官方工具 benchstat（需 go install golang.org/x/perf/cmd/benchstat@latest）能做统计比对。
步骤是：先保存旧版结果到文件，再跑新版，最后比对：
go test -bench=. -benchmem > old.txt # 修改代码后 go test -bench=. -benchmem > new.txt benchstat old.txt new.txt
输出会标出 p 值和变化百分比，例如 ±1.2% (p=0.003) 表示有统计显著性。
- 注意两次运行环境尽量一致（关闭无关进程、避免后台更新）
- 如果
benchstat报错 “no benchmarks found”，通常是文件里没匹配到Benchmark行，检查正则或空格 - 内存分配数（
allocs/op）比绝对时间更容易复现，优先关注它是否下降
真实项目里，微小优化常被 GC 或调度抖动掩盖，连续多次采样 + 统计比对才是可靠做法。
