Instalar WSL: Linux en Windows

01¿Qué es WSL y para qué sirve?

WSL (Windows Subsystem for Linux), en español subsistema de Windows para Linux, es una función de Microsoft que permite ejecutar un entorno Linux real dentro de Windows. Abre un terminal de Ubuntu sin crear una máquina virtual ni configurar un arranque dual; con apt instala paquetes y ejecuta scripts de bash.

En el desarrollo web, la gran mayoría de los servidores ejecutan Linux. Que el entorno en el que desarrolla se parezca al servidor de producción evita desde el principio los errores de rutas de archivos, permisos y mayúsculas y minúsculas que solo aparecen en el entorno en vivo. Node.js, Python, PHP, Ruby y la mayoría de las herramientas de bases de datos se instalan con menos problemas en Linux.

Diferencia entre WSL 1 y WSL 2

WSL 2 ejecuta un núcleo Linux real dentro de una máquina virtual ligera. Así funcionan herramientas que necesitan funciones del núcleo, como Docker, y las operaciones dentro del sistema de archivos de Linux son muy rápidas. WSL 1, en cambio, traduce las llamadas de Linux a Windows; a veces es más rápido al acceder a archivos de Windows, pero su compatibilidad es menor. En las instalaciones nuevas la versión predeterminada es WSL 2, y para la mayoría de los usuarios es la elección correcta.

02Requisitos previos

WSL es una función exclusiva de Windows; los usuarios de macOS y Linux no la necesitan, porque en esos sistemas ya hay un terminal basado en Unix. En el lado de Windows se necesitan algunas condiciones.

• Windows 11 o Windows 10 versión 2004 (compilación 19041) o superior; puede ver su versión con el comando winver.
• En los ajustes de BIOS/UEFI debe estar activada la virtualización (Intel VT-x o AMD-V/SVM). En el Administrador de tareas, pestaña Rendimiento, compruebe bajo CPU el texto Virtualización: Habilitada.
• Una cuenta de usuario con permisos de administrador.
• Unos cuantos GB de espacio libre en disco para la distribución y las herramientas.

03Instalar WSL 2 con un solo comando

En el menú Inicio, haga clic con el botón derecho en PowerShell y elija Ejecutar como administrador. El comando siguiente activa las funciones WSL y Plataforma de máquina virtual, descarga el núcleo de Linux e instala Ubuntu.

1. Cuando termine la instalación, reinicie el equipo.
2. Al iniciar, la ventana de Ubuntu aparece sola y descomprime los archivos; puede tardar unos minutos.
3. Defina el nombre de usuario y la contraseña de Linux. Esta cuenta es independiente de su cuenta de Windows; esta contraseña se pide en los comandos sudo.
4. Actualice la lista de paquetes y el sistema.

wsl --install

Primera actualización y comprobación

En el terminal de Ubuntu, actualice los paquetes y después, en PowerShell, liste las distribuciones instaladas y sus versiones. Si ve un 2 en la columna VERSION, WSL 2 está funcionando.

sudo apt update && sudo apt upgrade -y

wsl -l -v
wsl --status

04Elegir y gestionar la distribución

La distribución predeterminada es Ubuntu, pero también pueden instalarse Debian, openSUSE y otras. Usar Ubuntu en Windows es el camino más cómodo al principio, porque coincide al pie de la letra con la mayoría de los tutoriales y de la documentación.

• wsl --list --online lista las distribuciones que pueden instalarse.
• wsl --set-version pasa a WSL 2 una distribución instalada con WSL 1.
• wsl --shutdown apaga todas las distribuciones y la máquina virtual de WSL; es necesario después de cambiar ajustes.
• Para hacer una copia de seguridad de una distribución se usa wsl --export, y para restaurarla, wsl --import.

wsl --list --online
wsl --install -d Debian
wsl --set-default Ubuntu
wsl --set-default-version 2
wsl --set-version Ubuntu 2
wsl --update
wsl --shutdown

05¿Dónde deben estar los archivos?

En WSL conviven dos sistemas de archivos. Los discos de Windows se ven desde Linux con rutas como /mnt/c; los archivos de Linux, en cambio, se abren en el Explorador de Windows desde la dirección \\wsl.localhost\Ubuntu. Para acceder fácilmente desde el Explorador, puede escribir explorer.exe . en el terminal de Ubuntu.

La regla de oro es esta: guarde los archivos del proyecto en el sistema de archivos de Linux (por ejemplo, /home/usuario/proyectos). Los comandos npm install, git status o de compilación que se ejecutan bajo /mnt/c se ralentizan notablemente por la traducción entre los dos sistemas, y el seguimiento de archivos (hot reload) a veces no funciona en absoluto. La velocidad del entorno de desarrollo influye en la productividad del equipo tanto como los trabajos del lado de producción, como la gestión de velocidad y rendimiento.

06Conexión con VS Code, Git y Docker

Lo que hace realmente potente a WSL es que trabaja junto con las herramientas de Windows. El editor de código se abre en Windows, pero los comandos, las extensiones y el terminal se ejecutan dentro de Linux.

VS Code

Instale en VS Code la extensión WSL de Microsoft. Si entra en la carpeta del proyecto en el terminal de Ubuntu y escribe code . , el editor se abre en modo WSL; abajo a la izquierda aparece el indicador de conexión.

Git

Configure Git por separado dentro de Linux; los ajustes de Git de Windows no pasan a WSL. Para los ajustes detallados, consulte nuestra guía de instalación de Git.

sudo apt install git -y
git config --global user.name 'Ad Soyad'
git config --global user.email ad@ornek.com
git config --global core.autocrlf input

Docker

Docker Desktop utiliza en sus ajustes el motor basado en WSL 2 y se integra con las distribuciones que elija; así ejecuta los comandos docker desde el terminal de Ubuntu. Los pasos están en el artículo de instalación de Docker. Si prefiere instalar la base de datos directamente en Ubuntu en lugar de en un contenedor, los pasos de Linux de la guía de instalación de PostgreSQL funcionan igual en WSL.

07Un flujo de desarrollo típico en WSL

Una vez terminada la instalación, el trabajo diario se asienta en una rutina de pocos pasos. Basta con abrir el terminal de Ubuntu, entrar en la carpeta del proyecto del directorio personal e iniciar el editor con code . . Node.js se instala con nvm, Python con venv y la base de datos con apt o Docker; todo funciona con los mismos comandos que en el entorno Linux del servidor en vivo.

Esta rutina marca la diferencia sobre todo en proyectos en los que se comunican varios sistemas. Por ejemplo, probar en local sobre Linux el código de la integración de una tienda con los servicios de stock, envíos y contabilidad reduce las sorpresas al publicar. Las soluciones de software sectoriales, como la gestión de reservas o de anuncios, también suelen funcionar en servidores Linux, por lo que se desarrollan y prueban en el mismo entorno.

Si trabaja en equipo, que todos usen la misma distribución y las mismas versiones de las herramientas evita los problemas de «en mi equipo sí funciona». Escribir los pasos de instalación en un archivo README o en un script permite a quien se incorpora preparar su entorno en minutos.

08Ajuste de memoria y recursos

WSL 2 consume memoria según la necesita y, en sesiones largas, puede ralentizar Windows. Para ponerle un límite, cree el archivo .wslconfig en la carpeta de usuario de Windows (C:\Users\usuario). Tras el cambio, reinicie WSL con wsl --shutdown.

[wsl2]
memory=4GB
processors=2

09Errores frecuentes y soluciones

La mayoría de los errores de instalación de WSL se deben a que la virtualización está desactivada o a que faltan componentes de Windows. Anote el código de error y compárelo con la tabla siguiente.

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