本文详解 go 中使用 go test -bench 运行指定 benchmark 函数的正确语法，包括正则表达式用法、避免误匹配的边界处理，以及常见错误示例。
本文详解 go 中使用 go test -bench 运行指定 benchmark 函数的正确语法，包括正则表达式用法、避免误匹配的边界处理，以及常见错误示例。
在 Go 的测试生态中，go test 命令通过 -bench 标志支持基准测试（benchmark）的筛选执行。但许多开发者初次尝试时容易因语法细节出错——例如错误地加引号、混淆 -run 与 -bench 的用途，或忽略正则表达式的隐式匹配行为。
✅ 正确语法（两种等效形式）：
go test -bench BenchmarkMyTest go test -bench=BenchmarkMyTest
注意：不能加单引号或双引号（如 'BenchmarkMyTest'），否则 shell 会将其作为字面字符串传递，而 Go 测试框架期望接收的是未经引号包裹的正则表达式模式；同时，-run 标志仅用于 Test* 函数，对 Benchmark* 无效——使用 go test -run BenchmarkMyTest 将静默忽略基准测试。
⚠️ 关键陷阱：默认为子串匹配
由于 -bench 后参数被解释为 Go 的 regexp 模式，BenchmarkMyTest 实际会匹配所有包含该子串的函数名，例如：
- BenchmarkMyTest
- BenchmarkMyTestB
- MyBenchmarkMyTest
这往往导致非预期的多个 benchmark 被执行，影响结果准确性。
? 精准匹配单个函数：使用单词边界 \b
为确保仅匹配完整函数名，应在模式末尾添加 \b（表示“单词边界”，即后跟非字母数字或下划线的位置）：
go test -bench BenchmarkMyTest\b go test -bench=BenchmarkMyTest\b
Go 的 testing 包在识别 benchmark 函数时，已强制要求名称以 Benchmark 开头，因此无需在开头加 \b（如 \bBenchmarkMyTest\b 是冗余的）。同理，对单元测试可使用 go test -run TestMyTest\b。
? 额外提示：
- 若项目含多个包，需明确指定包路径：go test ./pkg/name -bench=BenchmarkMyTest\b
- 添加 -benchmem 可同时输出内存分配统计；
- 使用 -count=3 可重复运行 3 次取平均值，提升结果稳定性；
- 默认不运行 benchmark，务必显式指定 -bench，-bench=.（点号）才表示运行全部。
总结：掌握 -bench 的正则本质、摒弃引号、善用 \b 边界符，即可高效、准确地调试和对比单个 Go 基准测试函数。
