HomeAboutProjectsSchoolsBlog
Back
Guía Definitiva: Configurar WSL2 en Windows 10 (A prueba de errores)

Guía Definitiva: Configurar WSL2 en Windows 10 (A prueba de errores)

05/09/2024 - 14:45

El Subsistema de Windows para Linux (WSL2) ha cambiado las reglas del juego. Ya no necesitas un dual-boot defectuoso para desarrollar software profesionalmente. Esta guía cubre la instalación "a prueba de balas".

1. Prerrequisitos Críticos

Antes de escribir una sola línea de comando, verifica tu versión de Windows.

  • Presiona Win + R, escribe winver y enter.
  • Requisito: Windows 10 versión 2004 (Build 19041) o superior.
¡Alerta! Si tienes una versión anterior, ejecuta Windows Update antes de continuar. El 90% de los errores vienen de builds obsoletas.

2. Instalación en un solo comando (Método Moderno)

Desde las versiones recientes, PowerShell hace todo el trabajo pesado. Abre PowerShell como Administrador y ejecuta:

wsl --install

Este comando mágico hace 4 cosas por ti:

  1. Habilita los componentes opcionales de WSL y Plataforma de Máquina Virtual.
  2. Descarga e instala el último kernel de Linux.
  3. Configura WSL 2 como la versión por defecto.
  4. Descarga e instala Ubuntu (por defecto).

Reinicia tu computadora cuando te lo pida.

3. Solución de Problemas Comunes (Troubleshooting)

Error 0x80370102: Virtualización no habilitada

Si ves este error, significa que la virtualización está apagada en tu BIOS.

  • Reinicia y entra a la BIOS (F2, F10, o Del).
  • Busca "Intel Virtualization Technology" (VT-x) o "SVM Mode" (AMD) y ponlo en Enabled.
  • Guarda y sal (F10).

Error WSL Register Distribution Failed

A veces el kernel se corrompe. Descarga e instala el paquete de actualización manual: WSL2 Linux Kernel Update Package for x64 Machines.

4. Configurando Windows Terminal (Super Terminal)

La consola por defecto de Windows es... mejorable. Vamos a usar Windows Terminal para una experiencia profesional.

  1. Descarga Windows Terminal desde la Microsoft Store si no lo tienes.
  2. Abre la terminal y haz clic en la flecha hacia abajo v junto a las pestañas > Configuración.
  3. En la barra lateral izquierda, selecciona "Inicio".
  4. Cambia el "Perfil predeterminado" de PowerShell a Ubuntu.
  5. Haz clic en Guardar.

¡Listo! Ahora cada vez que abras la terminal, entrarás directamente a tu entorno Linux.

5. Configurando tu Entorno de Desarrollo

Una vez dentro de Ubuntu, actualiza los repositorios:

sudo apt update && sudo apt upgrade -y

Integración con VS Code

La magia real ocurre aquí. Desde tu terminal de Ubuntu, navega a tu carpeta de proyectos y escribe:

code .

VS Code detectará que estás en WSL e instalará la extensión "WSL Remote". Ahora tu editor corre en Windows, pero tu terminal, linter y compilador corren en Linux nativo. 🚀