Qué es WSL y cómo instalarlo en Windows

WSL (Windows Subsystem for Linux) es una característica de Windows que permite ejecutar un entorno Linux sin configurar una máquina virtual tradicional ni recurrir a un arranque dual.

Con WSL puedes utilizar Bash, Git, Python, Node.js y muchas otras herramientas de Linux sin dejar de trabajar en Windows. Además, ambos sistemas están integrados entre sí, por lo que puedes acceder a los archivos de Windows desde Linux, ejecutar aplicaciones de Windows desde Bash o editar un proyecto Linux con Visual Studio Code.

Qué es WSL

Durante mucho tiempo, trabajar en Windows con herramientas pensadas para Linux suponía instalar una máquina virtual, mantener una segunda partición o conformarse con soluciones parciales como Cygwin o Git Bash.

WSL proporciona un entorno GNU/Linux dentro de Windows en el que puedes instalar una distribución como Ubuntu o Debian. No es un emulador de comandos: ejecuta binarios y herramientas de Linux sin modificarlos y los integra con el escritorio de Windows.

Esto resulta especialmente útil en tareas como:

• Desarrollo web con Node.js, Python, Ruby o PHP.
• Automatización mediante Bash y otras utilidades de Linux.
• Conexión y administración de servidores mediante ssh, scp o rsync.
• Compilación y prueba de aplicaciones destinadas a servidores Linux.
• Uso de contenedores Linux con Docker Desktop.
• Aprendizaje de Linux sin cambiar el sistema operativo del equipo.

Diferencias entre WSL 1 y WSL 2

Existen dos arquitecturas de WSL. Las dos permiten ejecutar distribuciones de Linux, pero WSL 2 es la opción predeterminada y recomendada para la mayoría de los casos.

WSL 1 traduce las llamadas del sistema de Linux a operaciones que entiende Windows. Esto reduce el consumo de recursos y ofrece un acceso rápido a los archivos almacenados en Windows, pero no implementa todas las funciones de un kernel de Linux.

WSL 2 ejecuta un kernel de Linux dentro de una máquina virtual ligera administrada por Windows. No tienes que crear discos virtuales, configurar redes ni mantener esa máquina, pero sigue existiendo una capa de virtualización.

Para desarrollo general, contenedores o proyectos que utilizan muchas herramientas de Linux, elige WSL 2. WSL 1 continúa siendo útil en situaciones concretas, por ejemplo cuando un proyecto debe permanecer en el sistema de archivos de Windows y se accede constantemente a él desde herramientas de ambos sistemas.

Puedes consultar una comparación más detallada en la documentación oficial de Microsoft.

Requisitos para instalar WSL

El método moderno que veremos requiere Windows 11 o Windows 10 versión 2004 y compilación 19041 o posterior. Puedes comprobar la versión instalada pulsando Win + R, escribiendo winver y presionando Enter.

También necesitas una cuenta con permisos de administrador, conexión a Internet y espacio suficiente para WSL, la distribución y las herramientas que vayas a instalar. Para utilizar WSL 2, la virtualización debe estar habilitada en la BIOS o UEFI del equipo.

Cómo instalar WSL

La instalación actual se realiza con un único comando. Abre PowerShell o Windows Terminal como administrador y ejecuta:

wsl --install

Este comando habilita los componentes necesarios, instala WSL 2 y descarga Ubuntu como distribución predeterminada. Cuando termine, reinicia Windows si el instalador te lo solicita.

Elegir otra distribución

Ubuntu es una opción razonable para empezar, pero no es la única. Para ver las distribuciones disponibles, ejecuta:

wsl --list --online

Utiliza exactamente el nombre que aparece en la columna NAME. Por ejemplo, para instalar Debian:

wsl --install -d Debian

Puedes instalar varias distribuciones al mismo tiempo y mantener entornos separados para distintos proyectos. También puedes instalarlas desde Microsoft Store, aunque la línea de comandos suele ser más rápida y deja más claro qué distribución estás añadiendo.

Si ejecutas wsl --install y solo aparece la ayuda del comando, normalmente significa que WSL ya está instalado. En ese caso, lista las distribuciones disponibles e instala una indicando su nombre con -d.

Primera configuración de Linux

La primera vez que abras una distribución, WSL terminará de preparar sus archivos y te pedirá un nombre de usuario y una contraseña para Linux. Esta cuenta es independiente de tu usuario de Windows.

Al escribir la contraseña no verás asteriscos ni ningún otro carácter en la terminal. No se ha roto el teclado: es el comportamiento habitual de Linux. Escribe la contraseña y pulsa Enter.

En Ubuntu o Debian, conviene actualizar la lista de paquetes y las aplicaciones instaladas:

sudo apt update
sudo apt upgrade

La primera orden solicita información sobre las versiones disponibles. La segunda instala las actualizaciones, por lo que son operaciones diferentes aunque habitualmente se ejecuten una detrás de otra.

Comprobar y administrar WSL

Puedes gestionar WSL desde PowerShell, Windows Terminal o el símbolo del sistema. Estos son los comandos que usarás con más frecuencia:

Las nuevas distribuciones se instalan en WSL 2 de forma predeterminada. Si tienes una instalación antigua en WSL 1, puedes convertirla indicando el nombre que muestra wsl --list --verbose:

wsl --set-version Ubuntu 2

La conversión puede tardar varios minutos y necesita espacio libre en disco. Para establecer WSL 2 como versión predeterminada para las distribuciones que instales más adelante, utiliza:

wsl --set-default-version 2

Trabajar con archivos de Windows y Linux

WSL permite acceder a los archivos de ambos sistemas, pero conviene saber dónde guardar cada proyecto para evitar pérdidas de rendimiento.

Desde Linux, las unidades de Windows se montan dentro de /mnt. Por ejemplo, la raíz de la unidad C: está disponible en:

cd /mnt/c

Desde el Explorador de archivos de Windows puedes escribir \\wsl$ en la barra de direcciones para ver las distribuciones instaladas. También puedes utilizar una ruta explícita como \\wsl.localhost\Ubuntu\home\<usuario>.

La recomendación completa está explicada en la documentación sobre sistemas de archivos de WSL.

Usar WSL con Visual Studio Code

Visual Studio Code tiene una extensión oficial llamada WSL que permite mantener la interfaz del editor en Windows mientras el código, la terminal, Git y las herramientas de desarrollo se ejecutan dentro de Linux.

1. Instala Visual Studio Code en Windows y activa la opción para añadir code al PATH.
2. Instala la extensión WSL publicada por Microsoft.
3. Abre la distribución, entra en la carpeta del proyecto y ejecuta:

code .

VS Code abrirá esa carpeta en una sesión conectada a WSL. Algunas extensiones, como las de Python, depuración o linting, deben instalarse también dentro de la distribución; el propio editor te lo indicará cuando sea necesario.

Puedes ampliar esta configuración en la guía oficial de VS Code con WSL.

Usar WSL con Docker

Docker Desktop puede utilizar WSL 2 como motor para ejecutar contenedores Linux. De esta forma puedes lanzar docker desde tu distribución y trabajar con los mismos archivos y herramientas que utiliza el proyecto.

Tras instalar Docker Desktop, activa el motor basado en WSL 2 y habilita la integración para la distribución que quieras utilizar. Docker Desktop no es necesario para usar WSL; solo tienes que instalarlo si vas a trabajar con contenedores.

La configuración puede cambiar entre versiones, por lo que conviene seguir la documentación de Docker Desktop para WSL.

Limitar los recursos de WSL 2

WSL 2 gestiona automáticamente la memoria y los procesadores de su máquina virtual. Normalmente no necesitas cambiar nada, pero puedes establecer límites globales mediante el archivo %UserProfile%\.wslconfig si un entorno de desarrollo consume demasiados recursos.

Abre el archivo desde PowerShell con:

notepad "$env:USERPROFILE\.wslconfig"

Por ejemplo, esta configuración limita WSL 2 a 4 GB de memoria y dos procesadores:

[wsl2]
memory=4GB
processors=2

Después de guardar el archivo, detén WSL para aplicar los cambios:

wsl --shutdown

No establezcas límites demasiado bajos porque pueden ralentizar compilaciones, bases de datos y contenedores. Utiliza esta opción solo si tienes un problema real de consumo.

Solución de problemas habituales

La instalación se queda en el 0 %

Si la descarga de la distribución no comienza, Microsoft recomienda descargarla desde el origen web en lugar de utilizar Microsoft Store:

wsl --install --web-download -d Ubuntu

WSL 2 no puede iniciar la máquina virtual

Errores como 0x80370102 suelen indicar que la característica Plataforma de máquina virtual no está activa o que la virtualización está deshabilitada en la BIOS o UEFI.

Comprueba primero la pestaña Rendimiento > CPU del Administrador de tareas. En el apartado de virtualización debería aparecer Habilitado. Si no es así, consulta las instrucciones del fabricante del equipo antes de modificar la BIOS o UEFI.

WSL o el kernel están desactualizados

Actualiza WSL y reinicia su entorno con:

wsl --update
wsl --shutdown

Esto actualiza WSL, pero no los paquetes de Ubuntu o Debian. Para esos paquetes debes utilizar apt update y apt upgrade dentro de la distribución.