Instalar Node.js: Windows, macOS y Linux
Explicamos paso a paso, para tres sistemas operativos, cómo instalar Node.js con el instalador oficial o con nvm, cómo cambiar de versión y cómo verificar la instalación.
Aurora YazılımEquipo editorial
6 min de lectura
Para instalar Node.js basta con descargar de nodejs.org la versión LTS y ejecutar el instalador. Si va a usar versiones distintas en varios proyectos, instálelo con nvm en macOS y Linux o con nvm-windows en Windows. Después compruebe la versión en el terminal con los comandos node -v y npm -v; si ambos devuelven un número de versión, la instalación está completa.
Qué es Node.js y por qué instalarlo
Node.js es un entorno de ejecución que ejecuta JavaScript fuera del navegador, directamente en su equipo o en un servidor. Casi todos los proyectos web modernos necesitan Node.js durante el desarrollo: instalar paquetes, compilar y abrir un servidor de desarrollo local se hace siempre con él.
Aunque no utilice herramientas como React, Vite, Next.js o Tailwind, cuando quiera ejecutar un proyecto en su equipo el primer paso que suele aparecer es npm install. Este comando pertenece a npm, el gestor de paquetes que viene con Node.js; es decir, sin instalar Node.js no puede pasar de este paso.
En esta guía explicamos dos vías: el instalador oficial para quienes trabajarán con una sola versión y el gestor de versiones para quienes manejan varios proyectos. La tabla siguiente aclara cuál elegir.
| Método | Para quién | Ventaja | Inconveniente |
|---|---|---|---|
| Instalador oficial (.msi / .pkg) | Principiantes, un solo proyecto | La vía más fácil, unos pocos clics | Cambiar de versión es engorroso |
| nvm / nvm-windows | Varios proyectos, trabajo en equipo | Cambio entre versiones con un solo comando | La primera instalación es algo más técnica |
| Gestor de paquetes (brew, apt, winget) | Usuarios que prefieren el terminal | Instalación y actualización por comando | La versión del repositorio puede quedarse antigua |
Qué hace falta antes de instalar
Node.js es una instalación ligera, pero unos pocos preparativos evitan problemas posteriores. En especial, si su equipo ya tiene un Node.js antiguo instalado, instalar nvm sin desinstalarlo puede provocar un conflicto de PATH.
Preste atención también a la arquitectura del procesador. En los Mac con Apple Silicon (serie M) y en los dispositivos Windows basados en ARM, el instalador suele elegir por sí mismo la arquitectura correcta; si descarga a mano, no confunda los archivos x64 y ARM64. Una instalación con la arquitectura equivocada, aunque funcione, va más lenta o hace que algunos paquetes nativos no se puedan compilar.
En los equipos corporativos, un proxy o un cortafuegos puede bloquear la descarga de paquetes de npm. Si está en una red así, antes de instalar pida a su equipo de TI permiso de acceso a la dirección del registro de npm (registry.npmjs.org).
- Permisos de administrador: son necesarios para el instalador oficial en Windows y macOS; con nvm, como se instala en la carpeta del usuario, normalmente no hacen falta.
- Terminal: en Windows, PowerShell o Windows Terminal; en macOS, Terminal; en Linux, basta con el shell predeterminado.
- Desinstalar la instalación anterior: si va a pasar a un gestor de versiones, desinstale primero el Node.js existente desde Configuración > Aplicaciones o desde su gestor de paquetes.
- Elección de versión: en producción y mientras aprende, elija la versión LTS (soporte a largo plazo); la versión Current es para quienes quieren ver antes las novedades.
Instalar Node.js en Windows
En Windows hay tres vías: el instalador oficial .msi, winget, el gestor de paquetes propio de Windows, y nvm-windows para la gestión de versiones. Elija la que elija, después de instalar cierre y vuelva a abrir los terminales que estén abiertos; de lo contrario, no se verá la nueva configuración de PATH.
Con el instalador oficial
Descargue de nodejs.org el archivo .msi LTS para Windows, ejecute el instalador y avance con las opciones predeterminadas. El instalador instala npm junto con Node.js y lo añade automáticamente al PATH.
Con winget
Con winget, que viene incluido en Windows 10 y 11, puede instalar la versión LTS con un solo comando:
winget install OpenJS.NodeJS.LTSCon nvm-windows
Si necesita varias versiones, instale nvm-windows; es un proyecto distinto del nvm de macOS/Linux, aunque sus comandos son parecidos. Después de instalarlo, abra PowerShell como administrador y ejecute los comandos siguientes:
winget install CoreyButler.NVMforWindows
# Cierre y vuelva a abrir el terminal
nvm install lts
nvm use lts
nvm listInstalación con nvm en macOS y Linux
En macOS y Linux, la vía más sana es usar nvm (Node Version Manager). nvm instala Node.js en su carpeta de usuario; así no necesita usar sudo al instalar paquetes globales y se ahorra los errores de permisos.
El comando siguiente descarga y ejecuta el script de instalación de nvm. El README oficial recomienda una dirección con etiqueta de versión; lo más acertado es copiar el comando más reciente de la página de GitHub de nvm.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# Recargue el shell (elija uno según el que utilice)
source ~/.bashrc
source ~/.zshrc
# Compruebe que nvm está instalado
command -v nvmnvm install --lts
nvm use --lts
nvm alias default 'lts/*'Instalación en macOS con Homebrew
Si usa Homebrew, el comando brew install node también sirve. Pero este comando suele instalar la versión más reciente; si quiere ceñirse a la LTS, nvm es más flexible.
brew install nodeRepositorios de las distribuciones Linux
En Ubuntu o Debian funciona el comando sudo apt install nodejs npm, pero la versión del repositorio suele ser más antigua de lo que piden los proyectos actuales. Por eso recomendamos nvm en los equipos de desarrollo.
¿Cómo verifico la instalación?
Cuando termine la instalación, abra un terminal nuevo y ejecute los comandos siguientes. Ambos deben devolver un número de versión. Después compruebe con un pequeño script de prueba que Node.js ejecuta código.
- La salida de node -v es un número de versión que empieza por v.
- npm -v devuelve solo cifras; npm viene incluido con Node.js.
- Si el comando de prueba escribe el mensaje en pantalla, su entorno está listo; lo siguiente es la gestión de paquetes con los comandos de npm.
node -v
npm -v
node -e "console.log('Node.js funciona')"Cómo cambiar de versión de Node
Distintos proyectos pueden pedir distintas versiones de Node.js: un proyecto antiguo funciona con una versión antigua y uno nuevo con la LTS actual. Cambiar de versión de Node con nvm lleva unos segundos.
Si coloca un archivo .nvmrc en la carpeta raíz del proyecto, todos los miembros del equipo usan la misma versión. Basta con entrar en la carpeta y escribir nvm use para pasar a la versión indicada en el archivo (nvm-windows no lee el archivo .nvmrc; allí se escribe la versión a mano).
# Versiones instaladas
nvm ls
# Versiones LTS en el servidor remoto
nvm ls-remote --lts
# Instalar y cambiar a una versión principal concreta (ejemplo)
nvm install 20
nvm use 20
# Guardar la versión usada en el proyecto
node -v > .nvmrc
nvm useErrores frecuentes y soluciones
La mayoría de los problemas de la instalación de Node.js tienen que ver con el PATH y los permisos. La lista siguiente resume los errores que vemos con más frecuencia y sus soluciones rápidas.
No se reconoce el comando node
En Windows, el error «node is not recognized» suele aparecer porque el terminal se abrió antes de la instalación. Cierre y vuelva a abrir todos los terminales y VS Code; si el problema continúa, compruebe si la carpeta de Node.js está en la variable PATH.
Bloqueo de scripts de PowerShell
PowerShell puede negarse a ejecutar el archivo npm.ps1. Relajar la directiva de ejecución solo para su propio usuario resuelve el problema:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedError de permisos EACCES
Si en macOS o Linux obtiene un error EACCES al hacer npm install -g, es que Node.js se instaló en una carpeta del sistema. No ejecute npm con sudo; desinstale la instalación existente y vuelva a instalar con nvm.
nvm: command not found
El script de instalación añade las líneas de nvm al perfil de su shell, pero el terminal abierto no lo sabe. Ejecute source ~/.zshrc o source ~/.bashrc, o vuelva a abrir el terminal.
Qué hacer después de la instalación
Cuando Node.js esté listo, complete el resto del entorno de desarrollo: eche un vistazo a nuestras guías de instalación de VS Code, para el editor, y de subir un proyecto a GitHub, para guardar y compartir su código. Todas las explicaciones paso a paso están en la categoría de guías de instalación.
Si desarrolla un proyecto web para un negocio, las herramientas basadas en Node.js reducen durante la compilación las imágenes, el CSS y el JavaScript, y contribuyen directamente a la velocidad de la página. Tratamos este tema en detalle en nuestro servicio de velocidad y rendimiento.
Si no tiene un equipo propio o su proyecto requiere un sistema amplio, como una plataforma e-commerce, dejar la instalación y el desarrollo en manos de un equipo experto ahorra tiempo. En los proyectos de web corporativa y plataforma e-commerce instalamos todo el entorno nosotros y usted solo se centra en el contenido.
Preguntas frecuentes
01¿Debo instalar la versión LTS o la Current?
Para aprender, para proyectos profesionales y para servidores, elija la versión LTS; recibe actualizaciones de seguridad durante mucho tiempo. La versión Current es para quienes quieren probar pronto las novedades y tiene un periodo de soporte más corto.
02¿Tengo que instalar npm por separado?
No. El instalador oficial, nvm y nvm-windows instalan npm junto con Node.js. Si quiere actualizar npm, puede usar el comando npm install -g npm.
03¿Cómo desinstalo Node.js por completo de mi equipo?
En Windows, desinstálelo desde Configuración > Aplicaciones y elimine las carpetas npm y npm-cache de la carpeta de usuario. Si lo instaló con nvm, puede desinstalar las versiones una a una con el comando nvm uninstall.
04¿Debo usar nvm también en el servidor?
En servidores de desarrollo con un solo usuario, nvm es práctico. En los servidores de producción, en cambio, resultan más fáciles de administrar los métodos repetibles, como el repositorio de paquetes oficial de la distribución o el recomendado por Node.js, o una imagen de Docker.
Instalar bien Node.js hace que todos los pasos de desarrollo posteriores avancen sin problemas: bastan la versión LTS, una gestión flexible de versiones con nvm y un comando de verificación. Si en lugar de montar su proyecto desde cero busca un software a medida para su negocio o una solución de diseño web, conozca las soluciones de software a medida de Aurora Yazılım o contacte con nosotros.
