performance-benchmark

Generate and run ad hoc performance benchmarks to validate code changes. Use this when asked to benchmark, profile, or validate the performance impact of a code change in dotnet/runtime.

1. Napisz test wydajności używając BenchmarkDotNet. Utwórz klasę z metodą oznaczoną atrybutem [Benchmark], która testuje konkretną operację zmienianą w kodzie. Logikę inicjalizacji umieść w metodzie [GlobalSetup], aby nie mierzyć czasu alokacji pamięci.

2. Pamiętaj o najważniejszych zasadach: zwróć wartość z metody benchmarku, aby uniknąć optymalizacji kodu martwego, nie dodawaj pętli (BenchmarkDotNet sam je generuje), i upewnij się, że test nie ma efektów ubocznych. Testuj typowe przypadki użycia, nie przypadki brzegowe.

3. Przygotuj dane testowe, które będą identyczne dla każdego uruchomienia benchmarku. Konsystentne dane wejściowe zapewniają powtarzalne wyniki porównań wydajności.

4. Unikaj atrybutu [DisassemblyDiagnoser] na systemach Linux – powoduje błędy. Zamiast tego użyj zmiennej środowiskowej DOTNET_JitDisasm:MethodName do analizy kodu maszynowego.

5. Wyzwól uruchomienie benchmarku poprzez @EgorBot, podając kod testu. Bot automatycznie uruchomi test i wyśle Ci powiadomienie z wynikami – nie musisz czekać na zakończenie pomiaru.