google benchmark 是 c++ 轻量精准基准测试框架，支持量化执行时间、迭代次数与统计稳定性；需安装后用 benchmark 宏注册测试函数，在 state 循环中执行逻辑并用 pause/resumetiming 排除开销，推荐新版 benchmark_main() 自动处理。
Google Benchmark 是 C++ 项目中轻量、精准、易集成的基准测试框架，它能帮你量化函数或代码段的执行时间、迭代次数和统计稳定性，而不是简单用 clock() 或 std::chrono 手动测一次就完事。
快速上手：写一个最简 benchmark
先确保已安装 Google Benchmark（推荐用 vcpkg、conan 或源码编译）。在项目中包含头文件并定义测试函数：
- 每个测试函数以
BENCHMARK宏注册，接收benchmark::State&参数 - 在
state的循环中执行待测逻辑，每次调用state.PauseTiming()和state.ResumeTiming()可排除初始化/清理开销 - 必须在循环内调用
state.KeepRunning()（旧版）或使用BENCHMARK_MAIN()自动处理（推荐新版）
示例：
#include <benchmark/benchmark.h>
#include <vector>
void BM_VectorPushBack(benchmark::State& state) {
for (auto _ : state) {
std::vector<int> v;
for (int i = 0; i < state.range(0); ++i) {
v.push_back(i);
}
}
}
BENCHMARK(BM_VectorPushBack)->Range(1<<10, 1<<16);
BENCHMARK_MAIN();
控制测试维度：参数化与复杂场景
真实性能常依赖输入规模、配置或数据特征。Benchmark 提供灵活的参数机制：
立即学习“C++免费学习笔记（深入）”；
-
->Arg(N)指定单个输入值；->Args({a,b,c})测试多个离散值 -
->Range(low, high)指定对数步进范围（如1 到 <code>1），适合测试随规模增长的趋势 -
->Complexity()配合BENCHMARK_DEFINE_F类测试，自动拟合时间复杂度（O(1)/O(n)/O(n²)） - 用
state.range(0)、state.range(1)在测试体中读取当前参数值
避免常见陷阱：保证结果可信
不规范的写法会让结果失真，尤其在优化开启时：
- 别让编译器把待测逻辑整个优化掉——对计算结果做点“副作用”，比如
benchmark::DoNotOptimize(result)或存入volatile变量 - 避免在循环外构造/析构大对象（如容器、字符串），应放在
state循环内，或用state.PauseTiming()隔离准备阶段 - 禁用
-DNDEBUG外的宏干扰（如断言、日志），保持测试环境贴近生产构建配置 - 多次运行（默认 10 轮）+ 自动剔除离群值，比单次
std::chrono::high_resolution_clock::now()更鲁棒
运行与解读报告
编译后直接执行二进制文件，支持多种输出格式：
- 默认终端输出含：测试名、样本数、平均耗时（ns/op）、标准差、速率（如 items/s）
-
--benchmark_format=json输出结构化数据，便于 CI 解析或绘图 -
--benchmark_filter=BM_Vector*按名称筛选测试项 -
--benchmark_repetitions=5增加重复轮次提升统计置信度
重点关注 “mean” 和 “stddev” —— 若标准差超过均值 5%，说明结果波动大，需检查系统干扰（如 CPU 频率突变、后台进程）或逻辑是否稳定。
