BenchmarkDotNet para C# (.NET): guía completa con ejemplos

¿Qué es BenchmarkDotNet y para qué sirve?

BenchmarkDotNet es una potente biblioteca multiplataforma de código abierto para .NET, diseñada para medir con precisión el rendimiento del código (benchmarking). En el mundo del desarrollo de software, a menudo surge la necesidad de comparar dos o más enfoques para resolver un mismo problema: qué algoritmo de ordenamiento es más rápido, qué método de formateo de cadenas es más eficiente, cómo afecta el uso de diferentes estructuras de datos a la velocidad de la aplicación. BenchmarkDotNet resuelve esta tarea a nivel profesional.

¿Para qué sirve? La medición manual del tiempo con Stopwatch conlleva muchos errores: la influencia de procesos en segundo plano como la compilación JIT, la recolección de basura (GC), el calentamiento de la caché del procesador y las imprecisiones del temporizador del sistema. BenchmarkDotNet automatiza lo siguiente:

\n
• Calentamiento (Warmup): Ejecuta el código varias veces antes de la medición para que el compilador JIT y la caché del procesador entren en un estado estable.
\n
• Múltiples ejecuciones (Iterations): Ejecuta el método muchas veces y recopila estadísticas.
\n
• Análisis estadístico: Calcula la media, la mediana, la desviación estándar, el tiempo mínimo y máximo.
\n
• Aislamiento: Ejecuta cada benchmark en un proceso separado para minimizar la influencia de otras pruebas.
\n
• Diagnóstico: Puede medir no solo el tiempo, sino también la asignación de memoria (Allocated), la cantidad de recolecciones de basura (GC Collections) y otras métricas.
\n

Sin BenchmarkDotNet, corre el riesgo de obtener resultados poco fiables y sacar conclusiones incorrectas sobre la optimización del código.

Instalación de BenchmarkDotNet

La instalación de la biblioteca BenchmarkDotNet en un proyecto .NET (C#, F#, VB.NET) se realiza a través del administrador de paquetes NuGet. Existen tres formas principales:

1. A través de .NET CLI (recomendado)

Abra una terminal en la carpeta raíz de su proyecto y ejecute el comando:

dotnet add package BenchmarkDotNet

2. A través de la Consola del Administrador de Paquetes en Visual Studio

Abra el menú Tools -> NuGet Package Manager -> Package Manager Console y ejecute:

Install-Package BenchmarkDotNet

3. A través de la interfaz gráfica de NuGet en Visual Studio

Haga clic derecho en el proyecto en el Explorador de Soluciones, seleccione "Manage NuGet Packages", busque "BenchmarkDotNet" y haga clic en "Install".

Importante: Para un funcionamiento correcto, la biblioteca requiere que el proyecto esté compilado en configuración Release. La configuración Debug no optimiza el código, lo que dará lugar a resultados distorsionados.

Inicio rápido con un ejemplo de código

Escribamos un benchmark simple que compare dos formas de concatenar cadenas: mediante el operador + y mediante StringBuilder.

1. Cree un nuevo proyecto de consola .NET: dotnet new console -n MyBenchmark.

2. Instale la biblioteca: dotnet add package BenchmarkDotNet.

3. Reemplace el contenido del archivo Program.cs con el siguiente código:

using BenchmarkDotNet.Attributes;\nusing BenchmarkDotNet.Running;\nusing System.Text;\n\npublic class StringConcatenationBenchmark\n{\n    private const int N = 1000; // Número de iteraciones dentro del método\n\n    [Benchmark]\n    public string UsingPlusOperator()\n    {\n        string result = "";\n        for (int i = 0; i < N; i++)\n        {\n            result = result + "a";\n        }\n        return result;\n    }\n\n    [Benchmark]\n    public string UsingStringBuilder()\n    {\n        StringBuilder sb = new StringBuilder();\n        for (int i = 0; i < N; i++)\n        {\n            sb.Append("a");\n        }\n        return sb.ToString();\n    }\n}\n\npublic class Program\n{\n    public static void Main(string[] args)\n    {\n        var summa