Habilitar y configurar WSL2

Antes de usar WSL Dashboard, su sistema Windows debe tener correctamente habilitado y configurado el entorno WSL 2. Esta sección le guiará a través de la configuración básica necesaria.

1. Verificar los requisitos del sistema

WSL 2 tiene requisitos mínimos de versión de Windows. Presione Win + R, ingrese winver para verificar su versión:

• Windows 10: versión 1903 o superior, y la versión de compilación (Build) debe ser 18362 o superior.
• Windows 11: todas las versiones son compatibles.

IMPORTANT

Si su versión es demasiado antigua, primero actualice su sistema a través de "Windows Update".

2. Habilitar virtualización de hardware

WSL 2 funciona basado en tecnología de virtualización, por lo que debe habilitar Virtualization Technology en la BIOS/UEFI de la placa base.

• Método de verificación: Abra "Administrador de tareas" -> pestaña "Rendimiento" -> "CPU".
• Ver estado: Confirme que el estado de "Virtualización" en la esquina inferior derecha muestre "Habilitado".
• Forma de habilitar: Si no está habilitado, necesita reiniciar la computadora y acceder a la configuración BIOS/UEFI, buscar una opción similar a Intel VT-x o AMD-V y establecerla en Enabled.

3. Habilitar funciones relacionadas de Windows

Necesita habilitar las funciones "Windows Subsystem for Linux" y "Platforma de máquina virtual" de Windows.

Método A: A través de la interfaz gráfica (recomendado)

1. Presione Win + S, busque y abra "Activar o desactivar funciones de Windows".
2. Marque las siguientes dos opciones:
   • Windows Subsystem for Linux (Subsistema de Windows para Linux)
   • Platforma de máquina virtual (Virtual Machine Platform)
3. Haga clic en "Aceptar" y reinicie la computadora cuando se le solicite.

Método B: A través de la línea de comandos (con permisos de administrador)

Ejecute PowerShell como administrador y ejecute los siguientes comandos:

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

# Habilitar plataforma de máquina virtual
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Después de ejecutar, reinicie manualmente la computadora.

4. Instalar/actualizar el kernel de WSL

Las versiones modernas de Windows pueden obtener actualizaciones de WSL a través de Microsoft Store.

• URL de descarga: Microsoft Store - Windows Subsystem for Linux
• Descarga manual: Si no puede usar la tienda, puede descargar el paquete de instalación .msixbundle o .msi más reciente desde WSL GitHub Releases para una instalación sin conexión.

5. Establecer WSL 2 como versión predeterminada

Para确保 que las nuevas distribuciones instaladas usen WSL 2 de forma predeterminada, ejecute en la terminal:

wsl --set-default-version 2

Problemas comunes

• Error 0x80370102: Por lo general, se debe a que la virtualización no está habilitada en la BIOS o hay conflictos con Hyper-V.
• Cambio entre WSL 1 y WSL 2: Puede usar wsl --set-version <nombre de la distribución> 2 para actualizar una instancia existente de WSL 1 a WSL 2.