BenchmarkDotNet چیست؟

تعریف

BenchmarkDotNet کتابخانه‌ای است که یک متد را چندین بار (بعد از Warm-up کردن JIT) اجرا می‌کند و میانگین زمان اجرا، انحراف معیار و میزان تخصیص حافظه (Allocation) را با دقت بالا گزارش می‌دهد.

مثال

[MemoryDiagnoser]
public class StringConcatBenchmark
{
    [Benchmark(Baseline = true)]
    public string StringConcat()
    {
        var result = "";
        for (int i = 0; i < 1000; i++) result += i;
        return result;
    }

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

// اجرا: BenchmarkRunner.Run<StringConcatBenchmark>();

چرا نه فقط Stopwatch

Stopwatch یک بار اجرا را اندازه می‌گیرد که هنوز شامل هزینه JIT Compile و نویز سیستم‌عامل است؛ BenchmarkDotNet صدها/هزاران بار اجرا می‌کند، Outlier را حذف می‌کند و نتیجه آماری معتبر می‌دهد.

اشتباه رایج

❌ اجرای Benchmark در حالت Debug — بهینه‌سازی‌های کامپایلر در Debug غیرفعال است و نتایج کاملاً گمراه‌کننده می‌شوند؛ همیشه در Release اجرا شود.

منبع و مطالعه بیشتر

• BenchmarkDotNet — مستندات رسمی