benchstat是专用于对比go test -bench多轮输出的分析工具，非测试执行器；需确保Go≥1.21、GOBIN加入PATH、输入为规范纯文本、-count≥5、环境与参数严格一致，并重点关注每行Δ和p值而非Geomean。
benchstat 不是用来“跑测试”的，而是专门吃你跑完后存下来的多轮基准结果文件——喂错格式、少跑几轮、环境不一致，它直接报 no benchmarks found 或静默退出。
benchstat 命令找不到？先确认 GOBIN 和 Go 版本
Go 1.21+ 自带 benchstat，但不会自动加进 $PATH。它实际放在 go env GOBIN 指向的目录里。
- 执行
go version，确认 ≥ 1.21；否则benchstat压根不存在 - 运行
go env GOBIN，把输出路径加进 shell 的PATH（例如：export PATH="$(go env GOBIN):$PATH"） - Mac M 系列用 Homebrew 装的 Go？别依赖
/opt/homebrew/bin/benchstat，优先以GOBIN为准 - 旧版本（如 Go 1.20）强行
go install golang.org/x/perf/cmd/benchstat@latest可能因 ABI 不兼容导致解析失败
为什么 benchstat 报 no benchmarks found？90% 是输出保存错了
benchstat 只认标准纯文本格式的基准输出行，比如：BenchmarkParseJSON-8\t1000000\t1234 ns/op。任何额外字符、截断、换行符错误都会让它跳过整行甚至静默退出。
- 必须用重定向保存：
go test -bench=. -benchmem -count=5 > old.txt，别用tee或管道（缓冲可能丢末尾几行） - 严禁混入 stderr：
2>&1会把构建错误、panic 塞进文件，benchstat直接忽略含非基准字段的行 - Windows 用户注意：确保
old.txt和new.txt是 LF 换行（不是 CRLF），可用dos2unix转 - 如果用了
-json输出，必须显式加-json参数：benchstat -json old.json new.json，否则默认按文本解析失败
对比两次测试时，环境与参数对齐比代码还重要
benchstat 不关心你改了什么代码，只忠实地比对两组文本中同名 benchmark 的数字。只要环境或参数稍有偏差，差异就全是噪声。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 两次测试必须用完全相同的
GOOS、GOARCH、GOMAXPROCS、-gcflags，连GOGC都不能差 -
-count必须一致（推荐 ≥5），否则样本量不同，benchstat会拒绝比较 -
-benchtime也要一致；否则迭代次数波动大，ns/op计算基准不统一 - benchmark 名必须完全匹配：
BenchmarkFoo和BenchmarkFooParallel被视为不同项，不会对齐 - 真实机器上建议关掉 CPU 频率调节（Linux：
echo performance | sudo tee /sys/devices/system/cpu/cpu*/cpufreq/scaling_governor），笔记本务必关 Slack/Chrome
看 benchstat 输出时，盯住 Δ 和 p 值，别信 Geomean 和百分比本身
benchstat 默认第一行的 Geomean 是所有 benchmark 的几何平均归一化值，掩盖个体涨跌。一个函数快 50%、另一个慢 40%，Geomean 可能只显示 “-2%”，误导你判断整体变好。
- 真正该看的是每行末尾的
Δ列（如-8.33%）和p=0.12——p < 0.05才算统计显著 - 看到
+2.1% (p=0.003)？哪怕只涨一点点，只要p很小，就是极大概率真实退化 - 看到
-8.33% (p=0.12)？说明下降不显著，大概率是噪声，别急着回滚 - 想强制判断“有没有实质差异”，加
-delta-test=equal，它用等价性检验替代默认 t-test，更适合微小改动场景 - 出现
NaN或inf？通常是某轮耗时为 0（被编译器优化掉）或溢出，删掉对应行再跑，别留着污染统计
最常被忽略的一点：benchstat 只管你喂给它的那几个 Benchmark 函数。服务上线后变慢，但 benchstat 显示“无变化”？那问题大概率藏在 GC 压力、锁竞争、网络栈开销，或者编译器行为变化里——它不测这些，你得另配 pprof、blockprofile、mutexprofile 补位。
