Cómo instalar Node.js en Windows

JavaScript ejecuta la mayoría de los elementos interactivos en sitios web y aplicaciones móviles. JavaScript funciona perfectamente con HTML/CSS y está integrado en la mayoría de los navegadores populares. JavaScript puro se utiliza en la web, y para aplicaciones generales en JavaScript, los desarrolladores emplean diversos entornos de ejecución como Node.js.

Node.js es un entorno de ejecución para código JavaScript. Permite usar JavaScript como un lenguaje de propósito general, crear componentes del lado del servidor y desarrollar aplicaciones de escritorio completas.

La base de Node.js es el motor V8. Este motor fue desarrollado por Google y se utiliza en el navegador Google Chrome. Compila código JavaScript en código máquina que el procesador puede interpretar. Sin embargo, para convertir JavaScript en un lenguaje de propósito general, un motor por sí solo no es suficiente. Para crear una parte del servidor, por ejemplo, el lenguaje necesita trabajar con archivos, redes, etc. Para resolver esto, los desarrolladores añadieron más capacidades a V8 usando su propio código y bibliotecas de terceros. El resultado fue una herramienta que convierte JavaScript en un lenguaje de propósito general.

Node.js se ha vuelto popular entre los desarrolladores gracias a su capacidad de crear partes del servidor y del cliente en el mismo lenguaje, su velocidad y NPM. En este artículo explicamos cómo instalar correctamente Node.js en Windows 10/11.

Eliminar versiones antiguas

Antes de instalar, debes desinstalar versiones antiguas del entorno de ejecución si las tienes, ya que pueden causar conflictos.

Vamos a comprobar si el sistema tiene versiones instaladas de Node.js. Para ello, abre cmd (presiona Win+R, escribe cmd y pulsa Enter) y ejecuta el comando nvm list:

C:\Users\Hostman>nvm list
     18.9.0
     18.8.0
     16.17.0

Como puedes ver, tenemos varias versiones instaladas. Para eliminarlas:

1. Ejecuta el comando npm cache clean --force.

2. Ve a Agregar o quitar programas y desinstala Node.js.

3. Reinicia el equipo.

4. Elimina los siguientes directorios si existen:

C:\Program Files (x86)\Nodejs
C:\Program Files\Nodejs
C:\Users\{User}\AppData\Roaming\npm
C:\Users\{User}\AppData\Roaming\npm-cache
C:\Users\{User}\.npmrc
C:\Users\{User}\AppData\Local\Temp\npm-*

5. Vuelve a la línea de comandos y ejecuta nvm uninstall para cada versión mostrada en la salida de nvm list:

C:\Users\Hostman>nvm uninstall 18.9.0
Uninstalling node v18.9.0... done

C:\Users\Hostman>nvm uninstall 18.8.0
Uninstalling node v18.9.0... done

C:\Users\Hostman>nvm uninstall 16.17.0
Uninstalling node v18.9.0... done

6. Comprueba que las versiones se hayan eliminado:

C:\Users\Hostman>nvm list
'nvm' is not recognized as an internal or external command

C:\Users\Hostman>where node
No files matching the pattern were found

C:\Users\Hostman>where npm
No files matching the pattern were found

Instalar Node.js en Windows

Usar nvm-windows

Node Version Manager, o NVM, es un gestor de versiones de Node.js. Puedes necesitar diferentes versiones de Node y cambiar entre ellas mientras trabajas.

NVM es el gestor de versiones más común, pero no está disponible en Windows, por lo que se utiliza una versión adaptada llamada nvm-windows.

1. Visita el repositorio de nvm-windows en GitHub.

2. Descarga el instalador nvm-setup.exe para la última versión del gestor.

3. Una vez descargado, instálalo.

4. Cuando finalice la instalación, abre PowerShell como administrador y ejecuta nvm list available para ver la lista de versiones disponibles:

Si tu proyecto no requiere una versión específica, recomendamos seleccionar la última versión LTS para minimizar posibles problemas. Si deseas probar nuevas funciones o mejoras, puedes descargar la última versión, aunque existe un mayor riesgo de errores.

Vamos a instalar la última LTS. Revisa el número de versión en la salida de nvm list available e instálala usando nvm install:

PS C:\WINDOWS\system32> nvm install 20.13.1

Downloading node.js version 20.13.1 (64-bit)...
Extracting node and npm...
Complete
npm v10.5.2 installed successfully.
Installation complete. If you want to use this version, type
nvm use 20.13.1

En algunos casos, al instalar nvm-windows, puede ocurrir un problema: nvm no carga el gestor de paquetes NPM. En ese caso, recomendamos usar el método de instalación que se describe a continuación.

Usar el instalador oficial

1. Ve a la sección de descargas del sitio web oficial de Node.js.

2. Selecciona y descarga la versión que necesitas.

3. Una vez finalizada la descarga, abre el archivo y comenzará la instalación.

4. Sigue las instrucciones del instalador.

Instalar Node.js en WSL2

Si deseas usar Node.js con Docker, trabajar con la línea de comandos Bash o simplemente prefieres Linux, puedes considerar instalar Node.js en WSL2.

WSL (Windows Subsystem for Linux) es una capa de software que permite ejecutar aplicaciones creadas para sistemas Linux en Windows.

Esta sección contiene instrucciones para instalar WSL2.

El procedimiento de instalación de WSL2 en Windows 10 depende de la versión del sistema operativo. Para averiguarlo, presiona Win+R e introduce winver. Aparecerá la siguiente ventana:

Si es Windows 11, puedes continuar con el Método 1. Si es Windows 10, revisa la versión y compilación y selecciona el método adecuado.

Método 1: Para Windows 10 versión 2004 o superior, o Windows 11

Para este método, debes usar Windows 10 versión 2004 o superior (compilación 19041 o superior) o Windows 11.

En PowerShell, ejecutado como administrador, introduce los siguientes comandos:

wsl --install
wsl --set-version Ubuntu 2

Para comprobar el resultado, usa el comando wsl.exe -l -v:

PS C:\WINDOWS\system32> wsl.exe -l -v
   NAME STATE VERSION
* Ubuntu Stopped 2

Método 2: Para versiones de Windows 10 anteriores a 2004

Para este método, debes tener al menos la versión 1903 o superior con la compilación 18362.1049 o superior.

Ejecuta PowerShell como administrador y activa el Subsistema de Windows para Linux.

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

Luego, activa la función de máquina virtual:

dism.exe /online /enable-feature /featurename: VirtualMachinePlatform /all /norestart

Después de completar estos pasos, debes reiniciar el equipo.

Cuando el equipo se reinicie, descarga e instala el paquete de actualización del kernel de Linux desde el sitio oficial de Microsoft.

En PowerShell, selecciona la versión 2 de WSL como predeterminada:

wsl --set-default-version 2

Ahora vamos a descargar alguna distribución Linux. Puedes hacerlo directamente desde Microsoft Store.

Una vez finalizada la instalación, puedes acceder a la consola del sistema instalado desde el menú de búsqueda.

Conclusión

Node.js es un entorno de desarrollo popular utilizado por muchas empresas grandes, como PayPal, Yahoo, Ebay, General Electric, Microsoft y Uber.

En esta guía hemos revisado diferentes métodos para instalar Node.js en Windows 10 y 11.

Puedes consultar nuestra plataforma de aplicaciones para encontrar varios frameworks de Node.js, incluidos Express, Fastify, Hapi y Nest.