用 BenchmarkDotNet 做 C# 性能测试,核心就三点:写好待测方法、加特性标记、调用
Run。它会自动处理预热、迭代、统计和环境信息,比手写
Stopwatch更可靠、更专业。
1. 安装并配置 BenchmarkDotNet
在项目中安装 NuGet 包:
BenchmarkDotNet(必需) 可选:
BenchmarkDotNet.Diagnostics.Windows(Windows 下分析 GC/内存等)
推荐使用 .NET SDK 风格的项目(
.csproj),确保目标框架为
net6.0或更高(支持 JIT 预热与硬件计数器)。
2. 编写基准测试类
测试类必须是 public,方法需满足:
返回void无参数或仅接受
BenchmarkDotNet.Engines.IHost(极少用) 加上
[Benchmark]特性
示例:
[MemoryDiagnoser] // 自动报告内存分配
public class StringConcatBenchmark
{
private readonly string _a = "hello";
private readonly string _b = "world";
<pre class="brush:php;toolbar:false;">[Benchmark]
public string ConcatWithPlus() => _a + _b;
[Benchmark]
public string ConcatWithStringConcat() => string.Concat(_a, _b);
[Benchmark]
public string ConcatWithSpan() => $"{_a}{_b}";}
注意:避免在
[Benchmark]方法里做初始化(如 new 对象、读文件),应放在
[GlobalSetup]中。
3. 运行测试并解读结果
在
Main方法中调用:
var summary = BenchmarkRunner.Run<StringConcatBenchmark>();
运行后会输出表格,关键列包括:
Mean:平均执行时间(主参考指标) Error:统计误差范围(越小越可信) StdDev:标准差(反映稳定性) Gen0/Gen1/Gen2:各代 GC 次数(配合[MemoryDiagnoser]) Allocated:单次调用分配的内存字节数
若某方法 Mean 明显更低且 StdDev 小,通常就是更优实现。
4. 实用技巧与避坑点
不要用DateTime.Now或
Environment.TickCount手动计时 —— BenchmarkDotNet 用高精度硬件计数器(
RDTSC/
QueryPerformanceCounter) 避免“死码消除”:返回值必须被使用,例如
return结果给
BenchmarkDotNet内部消费,或用
[Benchmark(Description = "...")]辅助验证 复杂场景可加
[Params(100, 1000)]测试不同输入规模,生成多行对比 调试时加
[SimpleJob(runStrategy: RunStrategy.ColdStart)]强制冷启动,但正式测试保持默认(含预热)
基本上就这些。不复杂但容易忽略细节,比如忘记
[MemoryDiagnoser]就看不到内存开销,或者把初始化逻辑写进 Benchmark 方法里导致结果失真。
