C# Academy · 课时

使用 BenchmarkDotNet 进行基准测试

Q: 「使用 BenchmarkDotNet 进行基准测试」这节课中我会学到什么？

使用 BenchmarkDotNet 编写准确的微基准测试，分析吞吐量和分配，并避免常见陷阱。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

使用 BenchmarkDotNet 编写准确的微基准测试，分析吞吐量和分配，并避免常见陷阱。

第 4 / 4 课12 个步骤

使用 BenchmarkDotNet 进行基准测试 是 CoddyKit 上的免费 C# Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

为什么使用 BenchmarkDotNet

微基准测试出人意料地困难：JIT 预热、GC 暂停、CPU 缓存和 OS 调度都会引入噪声。BenchmarkDotNet 会自动处理所有这些问题，并生成统计上可靠的结果。

安装与首次基准测试

添加 NuGet 包，创建一个包含 [Benchmark] 方法的类，然后使用 BenchmarkRunner.Run 运行。始终在 Release 模式下运行基准测试。

// dotnet add package BenchmarkDotNet

using BenchmarkDotNet.Attributes;
using BenchmarkDotNet.Running;

[MemoryDiagnoser]           // report allocations
[RankColumn]                // rank methods by speed
public class StringBenchmarks
{
    [Benchmark(Baseline = true)]
    public string Concatenation()
    {
        var s = "";
        for (int i = 0; i < 100; i++) s += i;
        return s;
    }

    [Benchmark]
    public string StringBuilder()
    {
        var sb = new System.Text.StringBuilder();
        for (int i = 0; i < 100; i++) sb.Append(i);
        return sb.ToString();
    }
}

// Program.cs (must run as Release):
BenchmarkRunner.Run<StringBenchmarks>();

读取结果表

BenchmarkDotNet 会输出一个结果表，其中包含平均时间、误差、标准差、比率和内存分配。下面介绍如何解读每一列。

// Example output:
// | Method        |     Mean |   Error |  StdDev | Ratio | Alloc |
// |-------------- |---------:|--------:|--------:|------:|------:|
// | Concatenation | 4,210 ns |  81 ns  |  76 ns  |  1.00 | 6.4KB |
// | StringBuilder |   312 ns |   4 ns  |   4 ns  |  0.07 | 1.6KB |

// Mean:  average time per operation
// Error: half of 99.9% confidence interval
// StdDev: standard deviation — high value = noisy environment
// Ratio: relative to Baseline=true method (1.00)
// Alloc: managed heap allocated per operation

// Rule of thumb:
// Error should be < 5% of Mean for reliable results
// Run on an isolated machine (no background tasks)

参数化基准测试

使用 [Params] 让基准测试覆盖多个输入大小。BenchmarkDotNet 会运行每种组合，并为每个参数值生成单独的行。

[MemoryDiagnoser]
public class SearchBenchmarks
{
    [Params(10, 100, 1000, 10000)]
    public int N;

    private int[] _data = Array.Empty<int>();

    [GlobalSetup]
    public void Setup()
        => _data = Enumerable.Range(0, N).ToArray();

    [Benchmark]
    public bool LinearSearch()
        => Array.IndexOf(_data, N - 1) >= 0;

    [Benchmark]
    public bool BinarySearch()
        => Array.BinarySearch(_data, N - 1) >= 0;
}

设置与清理

使用生命周期特性运行一次性设置，或运行每次迭代的设置与清理。这会将设置成本排除在测量的基准测试时间之外。

[MemoryDiagnoser]
public class DbQueryBenchmarks
{
    private NpgsqlConnection _conn = null!;
    private NpgsqlCommand _cmd = null!;

    [GlobalSetup]              // runs once before all benchmarks
    public void Setup()
    {
        _conn = new NpgsqlConnection("...");
        _conn.Open();
        _cmd = new NpgsqlCommand("SELECT id FROM orders LIMIT 100", _conn);
    }

    [IterationSetup]           // runs before EACH benchmark iteration
    public void IterationSetup() { /* per-iteration prep */ }

    [Benchmark]
    public int QueryOrders() => (int)_cmd.ExecuteScalar()!;

    [GlobalCleanup]            // runs once after all benchmarks
    public void Cleanup() { _cmd.Dispose(); _conn.Dispose(); }
}

内存诊断

[MemoryDiagnoser] 会报告每次操作的托管堆分配量。将其与 [GcForce] 选项结合使用，可以控制基准测试期间的 GC 行为。

[MemoryDiagnoser]  // adds Alloc column to results
public class AllocationBenchmarks
{
    [Benchmark]
    public int[] AllocateArray() => new int[1000];

    [Benchmark]
    public Span<int> UseStackalloc()
    {
        Span<int> span = stackalloc int[1000];
        return span; // WARN: for illustration; don't return stackalloc
    }

    [Benchmark]
    public int[] ArrayPoolRent()
    {
        var arr = System.Buffers.ArrayPool<int>.Shared.Rent(1000);
        System.Buffers.ArrayPool<int>.Shared.Return(arr);
        return arr;
    }
}

诊断器：ETW 与反汇编

BenchmarkDotNet 支持多个诊断器。DisassemblyDiagnoser 会显示实际生成的本机汇编代码，非常适合验证 JIT 优化。

using BenchmarkDotNet.Diagnosers;

[DisassemblyDiagnoser(          // show generated ASM
    maxDepth: 2,
    printSource: true,
    exportGithubMarkdown: true)]
[MemoryDiagnoser]
public class VectorizationBenchmarks
{
    private float[] _data = new float[1024];

    [Benchmark]
    public float SumScalar()
    {
        float sum = 0;
        foreach (var v in _data) sum += v;
        return sum;
    }

    [Benchmark]
    public float SumVectorized()
        => System.Numerics.Vector<float>.Count > 1
            ? VectorSum(_data)
            : SumScalar();
}

作业配置

作业控制基准测试的执行环境，包括预热迭代次数、每次迭代的调用次数、.NET 运行时版本和 JIT 设置。您可以使用预定义作业或自定义作业。

using BenchmarkDotNet.Jobs;

// Compare JIT vs Native AOT performance:
[SimpleJob(RuntimeMoniker.Net90)]    // .NET 9 JIT
[SimpleJob(RuntimeMoniker.NativeAot90)] // .NET 9 AOT
[MemoryDiagnoser]
public class RuntimeComparison
{
    [Benchmark]
    public string SerializeJson()
    {
        var obj = new { Name = "Alice", Age = 30 };
        return System.Text.Json.JsonSerializer.Serialize(obj);
    }
}

// Custom job for more warmup:
[Config(typeof(MyConfig))]
public class PreciseBenchmarks
{
    private class MyConfig : ManualConfig
    {
        public MyConfig()
            => AddJob(Job.Default.WithWarmupCount(5).WithIterationCount(20));
    }
}

导出结果

BenchmarkDotNet 支持以多种格式导出结果，包括 Markdown（用于 GitHub 拉取请求）、CSV（用于电子表格）、JSON 和 HTML 图表。导出选项在作业配置中设置。

using BenchmarkDotNet.Exporters;
using BenchmarkDotNet.Exporters.Csv;

[Config(typeof(ExportConfig))]
public class MyBenchmarks { /* ... */ }

public class ExportConfig : ManualConfig
{
    public ExportConfig()
    {
        AddExporter(MarkdownExporter.GitHub);
        AddExporter(CsvExporter.Default);
        AddExporter(HtmlExporter.Default);
        // Results in: BenchmarkDotNet.Artifacts/results/
    }
}

// CLI usage to run specific benchmarks:
// dotnet run -c Release -- --filter "*StringBenchmarks*"
// dotnet run -c Release -- --list all  (list all benchmarks)

实战：优化前后对比

使用 BenchmarkDotNet 验证性能优化——比较朴素方法、池化方法和基于 Span 的方法。

[MemoryDiagnoser]
[RankColumn]
public class ParsingBenchmarks
{
    private const string Input = "2025-06-15T08:30:00Z";

    [Benchmark(Baseline = true)]
    public DateTime ParseViaString()
        => DateTime.Parse(Input);

    [Benchmark]
    public DateTime ParseExact()
        => DateTime.ParseExact(Input,
            "yyyy-MM-ddTHH:mm:ssZ",
            System.Globalization.CultureInfo.InvariantCulture);

    [Benchmark]
    public bool TryParse()
        => DateTime.TryParseExact(Input.AsSpan(),
            "yyyy-MM-ddTHH:mm:ssZ",
            System.Globalization.CultureInfo.InvariantCulture,
            System.Globalization.DateTimeStyles.None,
            out _);
}

快速检查

为什么必须使用 dotnet run -c Release 运行 BenchmarkDotNet 基准测试？

在交互式课程中回答

回顾：使用 BenchmarkDotNet 进行基准测试

要点：

通过 NuGet 安装；使用 [Benchmark] 标记方法；使用 dotnet run -c Release 运行
[MemoryDiagnoser]：添加分配列；[RankColumn]：按速度排名
[Params]：覆盖多个输入大小运行，以了解算法复杂度
[GlobalSetup] / [GlobalCleanup]：在测量时间之外执行一次性设置
[DisassemblyDiagnoser]：检查生成的本机 ASM，以验证 JIT 优化
使用作业比较 .NET 9 JIT、Native AOT 以及不同的迭代次数

免费开始

用 AI 导师学习 C# — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 93
课程: 346

免费开始学习查看完整课程

常见问题解答

「使用 BenchmarkDotNet 进行基准测试」课时是免费的吗？

是的 — 「使用 BenchmarkDotNet 进行基准测试」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「使用 BenchmarkDotNet 进行基准测试」这节课中我会学到什么？

使用 BenchmarkDotNet 编写准确的微基准测试，分析吞吐量和分配，并避免常见陷阱。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「使用 BenchmarkDotNet 进行基准测试」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

原生 AOT 编译
裁剪与反射限制
ReadyToRun 与分层编译
使用 BenchmarkDotNet 进行基准测试

← 返回 C# Academy