Instalación de .NET en Windows

En este artículo se explica qué versiones de .NET se admiten en Windows, cómo instalar .NET y cuál es la diferencia entre el SDK y el entorno de ejecución.

A diferencia de .NET Framework, .NET no está vinculado a la versión de Windows. Solo puede tener instalada una sola versión de .NET Framework en Windows. Pero .NET es independiente y se puede instalar en cualquier parte del equipo. Algunas aplicaciones pueden incluir su propia copia de .NET.

De forma predeterminada, .NET se instala en el directorio Program Files\dotnet del equipo, a menos que el método de instalación elija otro directorio.

.NET se compone del entorno de ejecución y del SDK. El tiempo de ejecución ejecuta aplicaciones .NET y el SDK se utiliza para crear aplicaciones.

Elección del runtime adecuado

Hay tres entornos de ejecución diferentes para Windows, que permiten ejecutar diferentes tipos de aplicaciones. El SDK incluye los tres entornos de ejecución, y un instalador para un entorno de ejecución podría incluir un entorno de ejecución adicional. En la tabla siguiente se describe qué tiempo de ejecución se incluye con un instalador de .NET determinado:

Para asegurarse de que puede ejecutar todas las aplicaciones de .NET en Windows, instale ASP.NET Core Runtime y .NET Desktop Runtime. El ASP.NET Core Runtime ejecuta aplicaciones basadas en web y .NET Desktop Runtime ejecuta aplicaciones de escritorio, como una aplicación de Windows Presentation Foundation (WPF) o Windows Forms.

Elija cómo instalar .NET

Hay diferentes maneras de instalar .NET y algunos productos pueden administrar su propia versión de .NET. Si instala .NET a través de software que administra su propia versión de .NET, es posible que no esté habilitada en todo el sistema. Asegúrese de comprender las implicaciones de instalar .NET a través de otro software.

Si no está seguro de qué método debe elegir después de revisar las listas de las secciones siguientes, es probable que quiera usar el instalador de .NET.

Desarrolladores

• Visual Studio

  Use Visual Studio para instalar .NET cuando quiera desarrollar aplicaciones de .NET mediante Visual Studio. Visual Studio administra su propia copia de .NET. Este método instala las plantillas SDK, Runtime y Visual Studio.

• Visual Studio Code - Kit de desarrollo de C#

  Instale la extensión C# Dev Kit para Visual Studio Code para desarrollar aplicaciones .NET. La extensión puede usar un SDK que ya esté instalado o instalar uno automáticamente.

Usuarios y desarrolladores

• Instalador de .NET

  Instale .NET con un paquete del instalador de Windows, que es un archivo ejecutable que se ejecuta. Este método puede instalar el SDK y el runtime. Las instalaciones se realizan en todo el sistema.

• Windows Administrador de paquetes (WinGet)

  Use WinGet para instalar .NET cuando quiera administrar .NET a través de la línea de comandos. Este método puede instalar el SDK y el runtime. Las instalaciones se realizan en todo el sistema.

• PowerShell

  Un script de PowerShell que puede automatizar la instalación del SDK o del entorno de ejecución. Puede elegir qué versión de .NET instalar.

Versiones compatibles

En la tabla siguiente se muestra una lista de las versiones de .NET admitidas actualmente y las versiones de Windows en las que se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llegue al final del soporte técnico o la versión de Windows alcanza el final de la vida.

Las fechas de fin de servicio de las versiones de Windows 10 se segmentan por edición. En la tabla que hay a continuación solo se tienen en cuenta las ediciones Home, Pro, Pro Education y Pro for Workstations. Consulte la hoja de información Windows ciclo de vida para obtener detalles específicos.

Windows 7 / 8.1 / Server 2012

Ya no hay una versión de .NET compatible con Windows 7 y Windows 8.1. Las últimas versiones admitidas se .NET 6 y el soporte técnico finalizó el 12 de noviembre de 2024.

Windows Server 2012 sigue siendo compatible con cualquier versión de .NET que siga siendo compatible.

Las tres versiones de estas Windows requieren que se instalen más dependencias:

Los requisitos anteriores también son necesarios si se encuentra con un error relacionado con uno de los archivos DLL siguientes:

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

PCs con Windows basado en Arm

.NET se admite en equipos Windows basados en Arm. En las secciones siguientes se describen los aspectos que debe tener en cuenta al instalar .NET.

Diferencias de ruta

En un equipo de Windows basado en Arm, todas las versiones arm64 de .NET se instalan en la carpeta normal C:\Program Files\dotnet\. Sin embargo, la versión x64 del SDK de .NET está instalada en la carpeta C:\Program Files\dotnet\x64\.

Variables de ruta

Las variables de entorno que agregan .NET a la ruta de acceso del sistema, como la variable PATH, pueden tener que cambiarse si tiene instaladas las versiones x64 y Arm64 del SDK de .NET. Además, algunas herramientas se basan en la variable de entorno DOTNET_ROOT, que también tendría que actualizarse para que apunte a la carpeta de instalación del SDK de .NET adecuada.

Instalación con Visual Studio

Visual Studio instala su propia copia de .NET independiente de otras copias de .NET. Diferentes versiones de Visual Studio admiten diferentes versiones de .NET. La versión más reciente de Visual Studio siempre admite la versión más reciente de .NET.

Visual Studio Instalador instala y configura Visual Studio. Algunas cargas de trabajo de Visual Studio incluyen .NET, como ASP.NET y desarrollo web y .NET desarrollo de la interfaz de usuario de aplicaciones multiplataforma. Se pueden instalar versiones específicas de .NET a través de la pestaña Individual Components.

La documentación de Visual Studio proporciona instrucciones sobre cómo:

• Install Visual Studio.
• Configurar cargas de trabajo de Visual Studio.

Una captura de pantalla que muestra Visual Studio Installer con la carga de trabajo .NET de escritorio resaltada con un cuadro rojo.

Versión de .NET y Visual Studio

Si usa Visual Studio para desarrollar aplicaciones .NET, en la tabla siguiente se describe la versión mínima necesaria de Visual Studio en función de la versión del SDK de .NET de destino.

Si ya tiene Visual Studio instalado, puede comprobar la versión con los pasos siguientes.

1. Abra Visual Studio.
2. Seleccione Help>About Microsoft Visual Studio.
3. Lea el número de versión del cuadro de diálogo "Acerca de".

Para obtener más información, consulte .NET SDK, MSBuild y control de versiones de Visual Studio.

Instalación con Visual Studio Code

Visual Studio Code es un editor de código fuente eficaz y ligero que se ejecuta en el escritorio. Visual Studio Code puede usar el SDK ya instalado en el sistema.

Este archivo de configuración WinGet instala el SDK de .NET más reciente, Visual Studio Code y C# DevKit. Si ya tiene alguno de ellos instalado, WinGet omitirá ese paso.

1. Descargue el archivo y haga doble clic para ejecutarlo.
2. Lea el contrato de licencia, escriba yy seleccione Escriba cuando se le pida que acepte.
3. Si recibe un mensaje de control de cuentas de usuario (UAC) parpadeante en la barra de tareas, permita que la instalación continúe.

Además, la extensión C# Dev Kit instalará .NET automáticamente si aún no está instalado.

Para obtener instrucciones sobre cómo instalar .NET a través de Visual Studio Code, consulte Introducción a C# en VS Code.

instalador de .NET

La página download para .NET proporciona archivos ejecutables del instalador de Windows.

1. Abra un explorador web y vaya a https://.

2. Seleccione la versión de .NET que desea descargar, como 10.0.

3. Busque el cuadro SDK o Runtime que contiene los vínculos para descargar .NET.

4. En la columna Installers, busque la fila Windows y seleccione el vínculo de la arquitectura de CPU. Si no conoce la versión, seleccione x64, que es la más común.

   El explorador debe descargar automáticamente el instalador.

   Sugerencia

   En la imagen siguiente se muestra el SDK, pero también puede descargar el runtime.

   

5. Abra Windows Explorer y vaya a la ubicación donde se descargó el archivo, probablemente la carpeta Downloads.

6. Haga doble clic en el archivo para instalar .NET.

   Se abre el cuadro de diálogo instalador de Windows.

   Una captura de pantalla de la ventana de la aplicación instaladora de .NET.

7. Seleccione Install y siga las instrucciones para instalar .NET.

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Opciones de línea de comandos

Use el parámetro para ver una lista de opciones.

Si desea instalar .NET silenciosamente, como en un entorno de producción o para admitir la integración continua, use las siguientes opciones:

• /install
  Instala .NET.

• /quiet
  Impide que se muestren interfaces de usuario y mensajes emergentes.

• /norestart
  Suprime los intentos de reinicio.

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

Si ya ha instalado .NET, use el instalador de .NET para administrar la instalación. En lugar de , use una de las opciones siguientes:

• /uninstall
  Quite esta versión de .NET.

• /repair
  Compruebe si los archivos o componentes clave de instalación están dañados y restáurelos.

Microsoft Update

Los archivos ejecutables del instalador de .NET son productos independientes que se pueden atender mediante Microsoft Update (MU) en Windows. MU es diferente a Windows Update (WU), que se usa para atender componentes del sistema operativo como .NET Framework.

Tanto las correcciones de seguridad como las que no son de seguridad para las versiones admitidas de .NET se proporcionan a través de MU mediante varios canales de distribución. Las actualizaciones automáticas (AU) son relevantes para los usuarios finales y los consumidores, mientras que Window Server Update Services (WSUS) y Windows Update Catálogo son relevantes para los administradores de TI.

Los archivos ejecutables del instalador de .NET admiten instalaciones en paralelo (SxS) en versiones principales y secundarias para diferentes arquitecturas y componentes, como el entorno de ejecución y el SDK. Por ejemplo, puede instalar el entorno de ejecución 6.0.15 (x64) y 6.0.17 (x86). Cuando MU se activa, ofrecerá el instalador más reciente para ambas instalaciones.

Bloquear actualizaciones

Aunque la mayoría de los usuarios prefieren mantenerse al día, es posible bloquear .NET actualizaciones mediante las claves del Registro de la tabla siguiente.

Actualizaciones automáticas del sistema operativo del servidor

WSUS y el Catálogo de Actualizaciones de Microsoft admiten las actualizaciones para sistemas operativos de servidor, pero no las Actualizaciones Automáticas. Los sistemas operativos de servidor pueden optar por recibir actualizaciones a través de AU mediante las siguientes claves del Registro.

WSUS y clasificaciones de actualización

WSUS se puede configurar para proporcionar actualizaciones específicas en función de su clasificación. Las actualizaciones de .NET se clasifican como security o critical. Si la actualización más reciente se clasifica como crítica, se puede ofrecer una actualización anterior security cuando se instala una versión anterior de .NET que se reemplaza por la actualización de seguridad más reciente. Esto también se aplica al uso del CAB sin conexión (Wsusscan2.cab) para examinar una máquina.

Elegir cuándo se quitan las versiones anteriores

Los ejecutables del instalador siempre instalan contenido nuevo antes de quitar la instalación anterior. Las aplicaciones que se ejecutan pueden interrumpirse o bloquearse cuando se quitan los entornos de ejecución anteriores. Para minimizar el impacto de actualizar .NET, puede especificar cuándo se debe quitar una instalación de .NET anterior mediante una clave del Registro.

• never conserva las instalaciones anteriores y requiere intervención manual para quitar las instalaciones de .NET anteriores.
• quita las instalaciones anteriores después de instalar la nueva versión. Este es el comportamiento predeterminado en .NET.
• aplaza la eliminación hasta la siguiente sesión de inicio de sesión de los miembros del grupo Administradores.
• Los valores no distinguen mayúsculas de minúsculas y los valores no válidos tienen como valor predeterminado .

Cuando se aplaza la eliminación, el instalador escribe un comando en la clave del Registro RunOnce para desinstalar la versión anterior. El comando solo se ejecuta si un usuario del grupo Administradores inicia sesión en el equipo.

Instalación con Windows Administrador de paquetes (WinGet)

Puede instalar y administrar .NET a través del servicio Windows Administrador de paquetes mediante la herramienta winget.exe. Para obtener más información sobre cómo instalar y usar WinGet, consulte Usar la herramienta WinGet para instalar y administrar aplicaciones.

Los paquetes winGet de .NET son:

• Microsoft.DotNet.Runtime.10: .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10: ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10—.NET Desktop Runtime 10.0
• Microsoft.DotNet.SDK.10: .NET SDK 10.0
• Microsoft.DotNet.Runtime.9: .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9: ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9: .NET Desktop Runtime 9.0
• Microsoft.DotNet.SDK.9: .NET SDK 9.0
• Microsoft.DotNet.Runtime.8: .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8: ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8: .NET Desktop Runtime 8.0
• Microsoft.DotNet.SDK.8: .NET SDK 8.0

Instalación del SDK

Si instala el SDK, no necesita instalar el runtime correspondiente.

1. Instalar WinGet.

2. Abra una terminal, como PowerShell o símbolo del sistema.

3. Ejecute el comando y pase el nombre del paquete del SDK:

   winget install Microsoft.DotNet.SDK.10
   

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Instalar el entorno de ejecución

Hay varios runtimes distintos que se pueden instalar. Consulte la sección Elegir el runtime correcto para comprender lo que se incluye con cada runtime.

1. Instalar WinGet.

2. Abra una terminal, como PowerShell o Símbolo del sistema.

3. Ejecute el comando y pase el nombre del paquete del SDK:

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Buscar versiones

Use el comando para buscar diferentes versiones del paquete que desea instalar. Por ejemplo, el comando siguiente busca todos los SDK de .NET disponibles a través de WinGet:

winget search Microsoft.DotNet.SDK

Los resultados de la búsqueda se imprimen en una tabla con cada identificador de paquete.

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

Instalación de versiones preliminares

Si hay disponible una versión preliminar, sustituya el número de versión del identificador por la palabra . En el ejemplo siguiente se instala la versión preliminar del entorno de ejecución de escritorio de .NET:

winget install Microsoft.DotNet.DesktopRuntime.Preview

Instalación con PowerShell

Se recomienda instalar .NET a través del script de PowerShell dotnet-install para las instalaciones de integración continua y no administrador. Si va a instalar .NET para su uso normal en el sistema, use los métodos de instalación .NET Installer o Windows Administrador de paquetes.

El script tiene como valor predeterminado instalar la versión más reciente de soporte a largo plazo (LTS), que es .NET 10. Puede elegir una versión específica especificando el interruptor. Incluya el conmutador para instalar un entorno de ejecución. De lo contrario, el script instala el SDK. El script está disponible en https://dot.net/v1/dotnet-install.ps1 y el código fuente se hospeda en GitHub.

Para obtener más información sobre el script, consulte -referencia del script de instalación.

Instalar el entorno de ejecución

El .NET Runtime se instala proporcionando el modificador -Runtime.

1. Descargar el script de instalación de

2. Abra PowerShell y vaya a la carpeta que contiene el script.

3. Ejecute los siguientes comandos para instalar el entorno de ejecución de escritorio y el entorno de ejecución de ASP.NET Core para obtener la máxima compatibilidad.

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Instalación del SDK

Si instala el SDK, no es necesario instalar los runtimes.

1. Descargar el script de instalación de

2. Abra PowerShell y vaya a la carpeta que contiene el script.

3. Ejecute el siguiente comando para instalar el SDK de .NET.

   dotnet-install.ps1
   

   Nota:

   El SDK se instala al omitir la opción.

Para obtener información sobre cómo usar la CLI de .NET, consulte .NET información general de la CLI.

Validación

Después de descargar un instalador o una versión binaria, compruébelo para asegurarse de que el archivo no se ha modificado ni dañado. Puede verificar la suma de comprobación en el equipo y, a continuación, compararla con lo notificado en el sitio web de descarga.

Al descargar un archivo desde una página de descarga oficial, la suma de comprobación del archivo se muestra en un cuadro de texto. Seleccione el botón Copiar para copiar el valor de la suma de comprobación al portapapeles.

Puede usar PowerShell o el símbolo del sistema de Windows para validar el valor de comprobación del archivo que ha descargado. Por ejemplo, el siguiente comando informa la suma de comprobación del archivo -sdk-9.0.306-win-x64.exe:

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

Compare la suma de comprobación con el valor proporcionado por el sitio de descarga.

Uso de PowerShell y un archivo de suma de comprobación para la validación

Las notas de la versión de .NET incluyen un enlace a un archivo de suma de verificación que puede usar para validar el archivo que ha descargado. En los pasos siguientes se describe cómo descargar el archivo de suma de comprobación y validar un archivo binario de instalación de .NET:

1. La página de notas de la versión de .NET 9 en GitHub en https://github.com/dotnet/core/tree/main/release-notes/9.0 contiene una sección denominada Releases. La tabla de esa sección se vincula a los archivos de descargas y suma de comprobación de cada versión de .NET 9. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   La tabla de versiones de las notas de lanzamientos de GitHub para .NET

2. Seleccione el vínculo de la versión de .NET que descargó. En la sección anterior se usó .NET SDK 9.0.306, que se encuentra en la versión de .NET 9.0.10.

   Sugerencia

   Si no está seguro de qué .NET versión contiene el archivo de suma de comprobación, explore los vínculos hasta que lo encuentre.

3. En la página de versión, puede ver la versión de .NET Runtime y .NET SDK y un vínculo al archivo de suma de comprobación. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   

4. Copie el vínculo al archivo de suma de comprobación.

5. Utilice el siguiente script, pero reemplace el enlace para descargar el archivo de suma de verificación adecuado.

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. Con el archivo de suma de comprobación y el archivo de versión de .NET descargados en el mismo directorio, busque la suma de comprobación de la descarga de .NET en el archivo de suma de comprobación.

   Cuando se supere la validación, verá que se imprime True (Verdadero):

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   Si ve que se imprime False (Falso), el archivo que ha descargado no es válido y no debe usarse.

Solución de problemas

Después de instalar el SDK de .NET, es posible que se produzcan problemas al intentar ejecutar .NET comandos de la CLI. En esta sección se recopilan esos problemas comunes y se proporcionan soluciones.

• No se encontró ningún SDK de .NET
• La compilación de aplicaciones es más lenta de lo esperado
• Falta

No se encontró ningún SDK de .NET

Lo más probable es que haya instalado las versiones x86 (32 bits) y x64 (64 bits) del SDK de .NET. Esto está causando un conflicto porque, al ejecutar el comando , se resuelve en la versión x86 cuando se debería resolver en la versión x64. Esto se corrige ajustando la variable para resolver primero la versión x64.

1. Compruebe que tiene ambas versiones instaladas mediante la ejecución del comando . Si lo hace, debería ver una entrada para las carpetas \ y (x86)\. Si la carpeta (x86)\ es la primera, tal como se demuestra en el siguiente ejemplo, es incorrecto y debe pasar al siguiente paso.

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   Sugerencia

   Aunque se usa en este ejemplo, puede ver otras copias de .exe enumeradas. Ajústalos para que se resuelva primero el .exe adecuado.

   Si es correcto y Program Files\ es el primero, no tiene el problema que esta sección trata y debe crear una solicitud de ayuda para .NET en GitHub.

2. Presione el botón Windows y escriba "Editar las variables de entorno del sistema" en la búsqueda. Seleccione Editar las variables de entorno del sistema.

   

3. La ventana Propiedades del sistema se abre en la pestaña Opciones avanzadas. Seleccione Variables de entorno.

   

4. En la ventana Variables de entorno, en el grupo Variables del sistema, seleccione la fila Path* y después seleccione el botón Editar.

   La ventana Variables de entorno con las variables de usuario y del sistema.

5. Usa los botones Subir y Bajar para mover la entrada C:\\\ por encima de C:\ (x86)\\.

   La lista de variables de entorno del sistema.

La compilación de aplicaciones es más lenta de lo esperado

Asegúrese de que Smart App Control, una característica de Windows, está desactivada. No se recomienda habilitar Smart App Control en las máquinas que se usan para el desarrollo. Cualquier configuración distinta de "desactivado" podría afectar negativamente al rendimiento de SDK.

Falta

Instale Microsoft Visual C++ 2015-2019 redistribuible (64 bits o 32 bits).

Contenido relacionado

• Información general de la CLI de .NET
• Upgrade a una nueva versión de .NET.
• Cómo comprobar si .NET ya está instalado.
• Tutorial: Creación de una nueva aplicación de consola.