WSL (Subsistema de Windows para Linux): qué es, instalación y configuración de Linux en Windows

Windows Subsystem for Linux (WSL, Subsistema de Windows para Linux) es un componente de Windows 10 y 11 que permite ejecutar una distribución Linux dentro de Windows: la terminal bash, apt, ssh, grep, Docker y cualquier utilidad de consola. No hace falta instalar VirtualBox ni dividir el disco para un segundo sistema: Ubuntu se abre como una ventana de terminal normal en unos segundos. A continuación se explica en qué se diferencian WSL 1 y WSL 2, cómo instalar el subsistema, cómo trabajar con archivos, VS Code y aplicaciones gráficas, y qué hacer con los errores más habituales.

Qué es WSL en Linux y en Windows

En resumen, WSL es una forma de tener un entorno Linux completo para desarrollar y aprender sin salir de Windows. Instala una distribución (Ubuntu, Debian, openSUSE, Kali, AlmaLinux y otras) desde la línea de comandos o desde Microsoft Store, y después trabaja en ella igual que en un servidor: usuarios, permisos, paquetes y servicios.

Conviene saber qué no hace WSL. No es un emulador de comandos como Cygwin ni un conjunto de utilidades portadas: en WSL 2 funciona un núcleo Linux real, compilado por Microsoft. Por eso los binarios de Linux se ejecutan sin recompilarse, y lo aprendido en WSL se traslada directamente a un servidor real.

Tareas típicas del subsistema:

• aprender Linux y la línea de comandos sin tener otro ordenador;
• desarrollo web cuando la producción funciona en Linux (Python, Node.js, PHP, Go);
• Docker Desktop, que usa WSL 2 como motor;
• conexión a servidores por SSH, scripts bash y trabajo con git en un entorno habitual.

WSL 1 y WSL 2: diferencias

Existen dos arquitecturas del subsistema. WSL 1 traduce las llamadas al sistema de Linux en llamadas al núcleo de Windows: no hay un núcleo Linux propiamente dicho. WSL 2 ejecuta un núcleo Linux real dentro de una máquina virtual ligera basada en Hyper-V, que arranca en segundos y gestiona su propia memoria.

Para casi todos los casos elija WSL 2, que es la opción por defecto. WSL 1 tiene sentido si no se puede activar la virtualización (por ejemplo, cuando Windows ya se ejecuta dentro de una máquina virtual sin virtualización anidada) o si el proyecto debe estar en el disco de Windows y trabajar activamente con él.

Cómo instalar WSL en Windows 10 y 11

En Windows 11 y en Windows 10 versión 2004 o posterior (compilación 19041 o superior), la instalación se reduce a un comando. Abra PowerShell o Terminal como administrador y ejecute:

wsl --install

El comando activa los componentes necesarios de Windows, descarga el núcleo de WSL 2 e instala Ubuntu. Tras reiniciar, se abre la ventana de la distribución: invente un nombre de usuario y una contraseña de Linux. No están vinculados a la cuenta de Windows; esta contraseña será la que pida sudo.

Enter new UNIX username: alex
New password:
Retype new password:
passwd: password updated successfully
Installation successful!

Actualice los paquetes de inmediato, como en cualquier servidor recién instalado:

sudo apt update && sudo apt upgrade -y

Cómo elegir la distribución

Ubuntu se instala por defecto, pero puede elegir otra distribución. Lista de las disponibles:

wsl --list --online

Instalación de una distribución concreta por su nombre de esa lista:

wsl --install -d Debian

Si WSL ya está instalado, el comando solo añade la nueva distribución. Puede tener varios sistemas a la vez, por ejemplo Ubuntu para trabajar y Kali para experimentar.

Comprobar la versión: wsl -l -v

Para ver las distribuciones instaladas, su estado y la versión de WSL:

wsl -l -v
  NAME      STATE           VERSION
* Ubuntu    Running         2
  Debian    Stopped         2

El asterisco marca la distribución por defecto, la que se abre con el comando wsl sin parámetros. Para cambiarla: wsl --set-default Debian.

Cómo pasar de WSL 1 a WSL 2

La versión para las nuevas instalaciones se define con:

wsl --set-default-version 2

Una distribución ya instalada se convierte por separado (los datos se conservan, pero el proceso puede tardar varios minutos):

wsl --set-version Ubuntu 2

La conversión inversa es wsl --set-version Ubuntu 1.

Comandos útiles para gestionar WSL

Tenga cuidado con --unregister: los archivos dentro de la distribución se borran sin papelera. Antes haga un --export.

Archivos de Windows desde Linux y viceversa

Los discos de Windows se montan automáticamente dentro de WSL en el directorio /mnt: el disco C: es /mnt/c, el D: es /mnt/d.

cd /mnt/c/Users/alex/Downloads
ls -l
cp report.csv ~/projects/

En sentido contrario, los archivos de Linux se ven en el Explorador de archivos por la ruta de red \\wsl$\Ubuntu (en Windows 11 también \\wsl.localhost\Ubuntu) y en la sección «Linux» de la barra lateral. Para abrir rápido el directorio actual de Linux en el Explorador:

explorer.exe .

Desde WSL se pueden ejecutar programas de Windows (notepad.exe, code), y desde PowerShell, comandos de Linux con el prefijo wsl: wsl ls -la. Para convertir rutas entre ambos sistemas existe la utilidad wslpath:

wslpath 'C:\Users\alex'
/mnt/c/Users/alex

La regla principal de rendimiento de WSL 2: guarde los proyectos en el sistema de archivos de Linux (~/projects), no en /mnt/c. El acceso a los discos de Windows se hace a través de un protocolo de red, y operaciones como git status o npm install en un proyecto grande van varias veces más lentas.

VS Code y WSL

Visual Studio Code puede trabajar con WSL como si fuera una máquina remota: la interfaz queda en Windows, mientras que la terminal, las extensiones, los intérpretes y el depurador se ejecutan dentro de Linux. Para ello hace falta la extensión WSL (de Microsoft). Después, desde la terminal de la distribución, vaya al directorio del proyecto y ejecute:

cd ~/projects/site
code .

La primera vez, VS Code instala en Linux su parte de servidor. En la esquina inferior izquierda aparecerá el indicador «WSL: Ubuntu», lo que indica que todo lo que ejecute desde la terminal integrada se ejecuta en Linux. Las extensiones como Python o ESLint deben instalarse «en WSL»: VS Code lo ofrecerá con un botón.

Aplicaciones gráficas en WSL (WSLg)

En Windows 11 y en las versiones actuales de WSL en Windows 10 existe WSLg, que da soporte a aplicaciones gráficas de Linux sin configurar un servidor X. Instale el programa como de costumbre, y su ventana aparecerá junto a las de Windows, con un acceso directo en el menú Inicio.

sudo apt install gedit -y
gedit ~/.bashrc &

WSLg admite X11 y Wayland, sonido y portapapeles. Aun así, para el trabajo diario con un escritorio Linux completo no es un sustituto: WSL está pensado para aplicaciones sueltas, no para ejecutar GNOME o KDE enteros.

systemd y recursos de WSL 2

Las versiones actuales de WSL 2 admiten systemd: en las instalaciones nuevas de Ubuntu viene activado por defecto. Si no lo está, añada en el archivo /etc/wsl.conf dentro de la distribución:

[boot]
systemd=true

y reinicie el subsistema desde PowerShell con wsl --shutdown. Después funcionan systemctl y servicios como nginx o PostgreSQL.

La memoria y los procesadores de la máquina virtual de WSL 2 se limitan en el archivo %UserProfile%\.wslconfig, en el lado de Windows:

[wsl2]
memory=4GB
processors=2

Los cambios se aplican tras ejecutar wsl --shutdown.

Errores típicos al instalar WSL

Error 0x80370102

Texto completo: «No se pudo iniciar la máquina virtual porque falta un componente necesario» (WslRegisterDistribution failed with error: 0x80370102). La causa casi siempre es una: WSL 2 no puede iniciar la máquina virtual. Compruebe en este orden:

1. Si la virtualización por hardware está activada en la BIOS/UEFI: Intel VT-x (Intel Virtualization Technology) o AMD-V (modo SVM). El estado aparece en el Administrador de tareas → «Rendimiento» → CPU → «Virtualización: Habilitado».
2. Si está activado el componente «Plataforma de máquina virtual».
3. Si el hipervisor no está desactivado en el cargador de arranque.

Los componentes se activan desde PowerShell como administrador:

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

Después reinicie el equipo. Si trabaja dentro de una máquina virtual, en el equipo anfitrión debe permitirse la virtualización anidada; si no, use WSL 1.

Otros problemas frecuentes

• 0x800701bc — el núcleo de WSL 2 no está actualizado. Ejecute wsl --update.
• El comando wsl --install solo muestra la ayuda — WSL ya está instalado; añada la distribución con wsl --install -d Ubuntu.
• No hay internet dentro de WSL con VPN — el cliente VPN intercepta las rutas de la red virtual. En Windows 11 ayuda el modo networkingMode=mirrored en la sección [wsl2] del archivo .wslconfig.
• WSL ocupa mucho espacio — el disco virtual ext4.vhdx crece, pero no se encoge solo al borrar archivos. Puede reducirlo manualmente o trasladar la distribución con --export/--import.
• Olvidó la contraseña de Linux — entre como root desde PowerShell con wsl -u root y ejecute passwd alex.

WSL, máquina virtual o arranque dual

WSL no es la única forma de tener Linux en un equipo con Windows. La elección depende de la tarea.

Para aprender Linux desde cero, WSL suele bastar: los archivos, los permisos, los procesos, los paquetes, los scripts bash y SSH funcionan igual que en un servidor. Una máquina virtual hace falta cuando llegan cosas que en WSL funcionan de otra manera: el cargador de arranque, el particionado de discos físicos, las interfaces de red y el cortafuegos a nivel de equipo.

Conclusión

El Subsistema de Windows para Linux le da un Linux real dentro de Windows con un solo comando, wsl --install. Elija WSL 2, compruebe las versiones con wsl -l -v, guarde los proyectos en ~/ y no en /mnt/c, y conecte VS Code mediante la extensión WSL. Si la instalación falla con 0x80370102, active la virtualización en la BIOS y el componente «Plataforma de máquina virtual». Preparar este entorno es el primer paso de la práctica en el curso de Linux.