Instrucciones de instalación de WSL 2Installation Instructions for WSL 2

Puede ver el vídeo siguiente o leer en este artículo para obtener información sobre cómo instalar WSL2.You can watch the video below, or read on in this article to learn how to install WSL2.

Para instalar y empezar a usar WSL 2, sigue estos pasos:To install and start using WSL 2 complete the following steps:

WSL 2 solo está disponible en las compilaciones 18917 o posteriores de Windows 10.WSL 2 is only available in Windows 10 builds 18917 or higher

  • Asegúrese de que ha instalado WSL (puede encontrar instrucciones para hacerlo aquí) y de que está ejecutando Windows 10 Build 18917 o superior.Ensure that you have WSL installed (you can find instructions to do so here) and that you are running Windows 10 build 18917 or higher
    • Para asegurarse de que está usando la compilación 18917 o posterior, únase al programa Windows Insider y seleccione el anillo "rápido" o el anillo "lento".To make sure you are using build 18917 or higher please join the Windows Insider Program and select the 'Fast' ring or the 'Slow' ring.
    • Para comprobar la versión de Windows, abra el símbolo del sistema y ejecute el comando ver.You can check your Windows version by opening Command Prompt and running the ver command.
  • Habilitación del componente opcional "Plataforma de máquina virtual"Enable the 'Virtual Machine Platform' optional component
  • Establecimiento de una distribución que respaldará WSL 2 mediante la línea de comandosSet a distro to be backed by WSL 2 using the command line
  • Comprobación de qué versiones de WSL están usando las distribucionesVerify what versions of WSL your distros are using

Habilite el componente opcional "plataforma de máquina virtual" y asegúrese de que WSL está habilitado.Enable the 'Virtual Machine Platform' optional component and make sure WSL is enabled

Tendrá que asegurarse de que tiene instalados los componentes opcionales del subsistema de Windows para Linux y de la plataforma de máquinas virtuales.You will need to make sure that you have both the Windows Subsystem for Linux and the Virtual Machine Platform optional components installed. Puede hacerlo mediante la ejecución del siguiente comando en PowerShell:You can do that by running the following command in PowerShell:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Reinicie el equipo para finalizar la instalación de ambos componentes.Please restart your machine to finish installing both components.

Establecimiento de una distribución que respaldará WSL 2 mediante la línea de comandosSet a distro to be backed by WSL 2 using the command line

Si no tiene instalado un distribución de Linux, consulte la página de documentos instalar en Windows 10 para obtener instrucciones sobre cómo instalar uno.If you do not have a Linux distro installed, please refer to the Install on Windows 10 docs page for instructions on installing one.

Para establecer un distribución, ejecute:To set a distro please run:

wsl --set-version <Distro> 2

Asegúrate de reemplazar <Distro> por el nombre real de tu distribución.and make sure to replace <Distro> with the actual name of your distro. (Puedes encontrarlo con el comando: wsl -l).(You can find these with the command: wsl -l). Puedes volver a cambiar a WSL 1 en cualquier momento; para ello, ejecuta el mismo comando que antes, pero reemplaza "2" por "1".You can change back to WSL 1 at anytime by running the same command as above but replacing the '2' with a '1'.

Además, si quieres que WSL 2 sea la arquitectura predeterminada, puedes hacerlo con este comando:Additionally, if you want to make WSL 2 your default architecture you can do so with this command:

wsl --set-default-version 2

Esto hará que las nuevas distribuciones que instales se inicialicen como distribución de WSL 2.This will make any new distro that you install be initialized as a WSL 2 distro.

Comprobación final de qué versiones de WSL están usando las distribucionesFinish with verifying what versions of WSL your distro are using

Para comprobar qué versiones de WSL usa cada distribución, use el siguiente comando (solo disponible en Windows compilación 18917 o posterior):To verify what versions of WSL each distro is using use the following command (only available in Windows Build 18917 or higher):

wsl --list --verbose o wsl -l -vwsl --list --verbose or wsl -l -v

La distribución que has elegido anteriormente debería mostrar ahora un "2" en la columna "version" (versión).The distro that you've chosen above should now display a '2' under the 'version' column. Ahora que ya has completado los pasos, puedes empezar a usar tu distribución de WSL 2.Now that you're finished feel free to start using your WSL 2 distro!

Solución de problemas:Troubleshooting:

A continuación se muestran errores relacionados con la instalación de WSL 2 y las correcciones sugeridas.Below are related errors and suggested fixes when installing WSL 2. Consulta la página de solución de problemas de WSL para ver otros errores generales de WSL y sus soluciones.Please refer to the WSL troubleshooting page for other general WSL errors and their solutions.

  • Error en la instalación 0x80070003 o 0x80370102Installation failed with error 0x80070003 or error 0x80370102

    • Asegúrate de que la virtualización está habilitada dentro del BIOS del equipo.Please make sure that virtualization is enabled inside of your computer's BIOS. Las instrucciones sobre cómo hacerlo variarán de un equipo a otro y lo más probable es que esta característica esté en opciones relacionadas con la CPU.The instructions on how to do this will vary from computer to computer, and will most likely be under CPU related options.
  • Error al intentar actualizar: Invalid command line option: wsl --set-version Ubuntu 2Error when trying to upgrade: Invalid command line option: wsl --set-version Ubuntu 2

    • Asegúrate de que tienes el Subsistema de Windows para Linux habilitado y de que estás usando la compilación 18917 de Windows o posterior.Please make sure that you have the Windows Subsystem for Linux enabled, and that you're using Windows Build version 18917 or higher. Para habilitar WSL, ejecuta este comando en un símbolo del sistema de PowerShell con privilegios de administrador: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux.To enable WSL run this command in a Powershell prompt with admin privileges: Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux. Puedes encontrar las instrucciones de instalación de WSL completas aquí.You can find the full WSL install instructions here.
  • No se pudo completar la operación solicitada debido a una limitación del sistema de disco virtual. Los archivos de disco duro virtual deben estar sin comprimir y sin cifrar y no deben ser dispersos.The requested operation could not be completed due to a virtual disk system limitation. Virtual hard disk files must be uncompressed and unencrypted and must not be sparse.

  • El término ' WSL ' no se reconoce como nombre de un cmdlet, función, archivo de script o programa ejecutable.The term 'wsl' is not recognized as the name of a cmdlet, function, script file, or operable program.