Dela via

Konfigurationsalternativ för körning för kompilering

Den här artikeln beskriver de inställningar som du kan använda för att konfigurera .NET-kompilering.

Kommentar

.NET 6 standardiserar på prefixet DOTNET_ i stället COMPlus_ för för miljövariabler som konfigurerar .NET-körningsbeteende. Prefixet COMPlus_ fortsätter dock att fungera. Om du använder en tidigare version av .NET-körningen bör du fortfarande använda prefixet COMPlus_ för miljövariabler.

Nivåindelad kompilering

  • Konfigurerar om jit-kompilatorn (just-in-time) använder nivåindelad kompilering. Nivåindelade kompileringsövergångar metoder via två nivåer:
    • Den första nivån genererar kod snabbare (snabb JIT) eller läser in förkompilerad kod (ReadyToRun).
    • Den andra nivån genererar optimerad kod i bakgrunden ("optimera JIT").
  • I .NET Core 3.0 och senare aktiveras nivåindelad kompilering som standard.
  • I .NET Core 2.1 och 2.2 inaktiveras nivåindelad kompilering som standard.
  • Mer information finns i kompileringsguiden för nivåindelad nivå.
Inställningsnamn Värden
runtimeconfig.json System.Runtime.TieredCompilation true -Aktiverat
false -Inaktiverad
MSBuild-egenskap TieredCompilation true -Aktiverat
false -Inaktiverad
Miljövariabel COMPlus_TieredCompilation eller DOTNET_TieredCompilation 1 -Aktiverat
0 -Inaktiverad

Exempel

runtimeconfig.json fil:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation": false
      }
   }
}

runtimeconfig.template.json fil:

{
   "configProperties": {
      "System.Runtime.TieredCompilation": false
   }
}

Projektfil:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TieredCompilation>false</TieredCompilation>
  </PropertyGroup>

</Project>

Snabb JIT

  • Konfigurerar om JIT-kompilatorn använder snabb JIT. För metoder som inte innehåller loopar och för vilka förkompilerad kod inte är tillgänglig, kompilerar snabb JIT dem snabbare men utan optimeringar.
  • Aktivering av snabb JIT minskar starttiden men kan generera kod med försämrade prestandaegenskaper. Koden kan till exempel använda mer stackutrymme, allokera mer minne och köra långsammare.
  • Om snabb JIT inaktiveras men nivåindelad kompilering är aktiverad, deltar endast förkompilerad kod i nivåindelad kompilering. Om en metod inte förkompileras med ReadyToRun är JIT-beteendet detsamma som om nivåindelad kompilering inaktiverades.
  • I .NET Core 3.0 och senare aktiveras snabb JIT som standard.
  • I .NET Core 2.1 och 2.2 inaktiveras snabb-JIT som standard.
Inställningsnamn Värden
runtimeconfig.json System.Runtime.TieredCompilation.QuickJit true -Aktiverat
false -Inaktiverad
MSBuild-egenskap TieredCompilationQuickJit true -Aktiverat
false -Inaktiverad
Miljövariabel COMPlus_TC_QuickJit eller DOTNET_TC_QuickJit 1 -Aktiverat
0 -Inaktiverad

Exempel

runtimeconfig.json fil:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation.QuickJit": false
      }
   }
}

runtimeconfig.template.json fil:

{
   "configProperties": {
      "System.Runtime.TieredCompilation.QuickJit": false
   }
}

Projektfil:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TieredCompilationQuickJit>false</TieredCompilationQuickJit>
  </PropertyGroup>

</Project>

Snabb JIT för loopar

  • Konfigurerar om JIT-kompilatorn använder snabb JIT på metoder som innehåller loopar.
  • Om du aktiverar snabb JIT för loopar kan startprestanda förbättras. Långvariga loopar kan dock fastna i mindre optimerad kod under långa perioder.
  • Om snabb-JIT är inaktiverat har den här inställningen ingen effekt.
  • Om du utelämnar den här inställningen används inte snabb-JIT för metoder som innehåller loopar. Detta motsvarar att ange värdet till false.
Inställningsnamn Värden
runtimeconfig.json System.Runtime.TieredCompilation.QuickJitForLoops false -Inaktiverad
true -Aktiverat
MSBuild-egenskap TieredCompilationQuickJitForLoops false -Inaktiverad
true -Aktiverat
Miljövariabel COMPlus_TC_QuickJitForLoops eller DOTNET_TC_QuickJitForLoops 0 -Inaktiverad
1 -Aktiverat

Exempel

runtimeconfig.json fil:

{
   "runtimeOptions": {
      "configProperties": {
         "System.Runtime.TieredCompilation.QuickJitForLoops": false
      }
   }
}

runtimeconfig.template.json fil:

{
   "configProperties": {
      "System.Runtime.TieredCompilation.QuickJitForLoops": false
   }
}

Projektfil:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TieredCompilationQuickJitForLoops>true</TieredCompilationQuickJitForLoops>
  </PropertyGroup>

</Project>

ReadyToRun

  • Konfigurerar om .NET Core-körningen använder förkompilerad kod för avbildningar med tillgängliga ReadyToRun-data. Om du inaktiverar det här alternativet framtvingas körningen till JIT-kompilera ramverkskod.
  • Mer information finns i Redo att köras.
  • Om du utelämnar den här inställningen använder .NET ReadyToRun-data när de är tillgängliga. Detta motsvarar att ange värdet till 1.
Inställningsnamn Värden
Miljövariabel COMPlus_ReadyToRun eller DOTNET_ReadyToRun 1 -Aktiverat
0 -Inaktiverad

Profilstyrd optimering

Den här inställningen möjliggör dynamisk (nivåindelad) profilstyrd optimering (PGO) i .NET 6 och senare versioner.

Inställningsnamn Värden
Miljövariabel DOTNET_TieredPGO 1 -Aktiverat
0 -Inaktiverad
MSBuild-egenskap TieredPGO true -Aktiverat
false -Inaktiverad

Profilstyrd optimering (PGO) är den plats där JIT-kompilatorn genererar optimerad kod när det gäller de typer och kodsökvägar som används oftast. Dynamisk PGO fungerar hand i hand med nivåindelad kompilering för att ytterligare optimera kod baserat på ytterligare instrumentation som införs under nivå 0.

Exempel

Projektfil:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TieredPGO>true</TieredPGO>
  </PropertyGroup>

</Project>