Opciones de configuración de ejecución para compilación

En este artículo se detallan los valores que se pueden usar para configurar la compilación de .NET.

Nota:

.NET 6 estandariza en el prefijo DOTNET_ en lugar de en COMPlus_ para las variables de entorno que configuran el comportamiento en tiempo de ejecución de .NET. Sin embargo, el prefijo COMPlus_ seguirá funcionando. Si usa una versión anterior del runtime de .NET, debe seguir usando el prefijo COMPlus_ para las variables de entorno.

Compilación en niveles

  • Configura si el compilador Just-In-Time (JIT) usa la compilación en niveles. La compilación en niveles realiza la transición de métodos mediante dos niveles:
    • El primer nivel genera código más rápidamente (JIT rápido) o carga código previamente compilado (ReadyToRun).
    • El segundo nivel genera código optimizado en segundo plano ("JIT de optimización").
  • En la versión 3.0 de .NET Core y posteriores, la compilación en niveles está habilitada de forma predeterminada.
  • En las versiones 2.1 y 2.2 de .NET Core, la compilación en niveles está deshabilitada de forma predeterminada.
  • Para obtener más información, vea la Guía de compilación en niveles.
Nombre de valor Valores
runtimeconfig.json System.Runtime.TieredCompilation true: habilitado.
false: deshabilitado.
Propiedad de MSBuild TieredCompilation true: habilitado.
false: deshabilitado.
Variable del entorno COMPlus_TieredCompilation o DOTNET_TieredCompilation 1: habilitado.
0: deshabilitado.

Ejemplos

Archivo runtimeconfig.json:

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

Archivo del proyecto:

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

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

</Project>

JIT rápido

  • Configura si el compilador JIT usa JIT rápido. En el caso de los métodos que no contienen bucles y para los que no hay código compilado previamente, JIT rápido los compila más rápidamente, pero sin optimizaciones.
  • La habilitación de JIT rápido reduce el tiempo de inicio, pero puede generar código con características de rendimiento degradadas. Por ejemplo, el código puede usar más espacio de pila, asignar más memoria y ejecutarse más lentamente.
  • Si JIT rápido está deshabilitado pero la compilación en niveles está habilitada, solo el código compilado previamente participa en la compilación en niveles. Si un método no está compilado previamente con ReadyToRun, el comportamiento de JIT es el mismo que si la compilación en niveles estuviera deshabilitada.
  • En .NET Core 3.0 y versiones posteriores, JIT rápido está habilitado de forma predeterminada.
  • En .NET Core 2.1 y 2.2, JIT rápido está deshabilitado de forma predeterminada.
Nombre de valor Valores
runtimeconfig.json System.Runtime.TieredCompilation.QuickJit true: habilitado.
false: deshabilitado.
Propiedad de MSBuild TieredCompilationQuickJit true: habilitado.
false: deshabilitado.
Variable del entorno COMPlus_TC_QuickJit o DOTNET_TC_QuickJit 1: habilitado.
0: deshabilitado.

Ejemplos

Archivo runtimeconfig.json:

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

Archivo del proyecto:

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

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

</Project>

JIT rápido para bucles

  • Configura si el compilador JIT usa JIT rápido en métodos que contienen bucles.
  • La habilitación de JIT rápido para bucles puede mejorar el rendimiento de inicio. Pero los bucles de ejecución prolongada se pueden bloquear en código menos optimizado durante períodos largos.
  • Si JIT rápido está deshabilitado, este valor no tiene ningún efecto.
  • Si se omite esta configuración, el método JIT rápido no se utiliza para los métodos que contienen bucles. Esto es equivalente a establecer el valor en false.
Nombre de valor Valores
runtimeconfig.json System.Runtime.TieredCompilation.QuickJitForLoops false: deshabilitado.
true: habilitado.
Propiedad de MSBuild TieredCompilationQuickJitForLoops false: deshabilitado.
true: habilitado.
Variable del entorno COMPlus_TC_QuickJitForLoops o DOTNET_TC_QuickJitForLoops 0: deshabilitado.
1: habilitado.

Ejemplos

Archivo runtimeconfig.json:

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

Archivo del proyecto:

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

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

</Project>

ReadyToRun

  • Configura si el entorno de ejecución de .NET Core usa código precompilado para las imágenes con datos de ReadyToRun disponibles. Al deshabilitar esta opción, se fuerza al entorno de ejecución a compilar código de marco mediante JIT.
  • Para obtener más información, consulte Ready to Run.
  • Si se omite esta configuración, .NET usa datos ReadyToRun cuando están disponibles. Esto es equivalente a establecer el valor en 1.
Nombre de valor Valores
Variable del entorno COMPlus_ReadyToRun o DOTNET_ReadyToRun 1: habilitado.
0: deshabilitado.

Optimización guiada por perfiles

Esta configuración habilita la optimización dinámica o la optimización guiada por perfiles (PGO) en capas en .NET 6 y versiones posteriores.

Nombre de valor Valores
Variable del entorno DOTNET_TieredPGO 1: habilitado.
0: deshabilitado.