Cómo instalar NVM en Windows, macOS y Linux

¿Cómo instalar NVM?

Respuesta corta: En macOS y Linux, ejecuta el script oficial curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash, abre una terminal nueva y ejecuta nvm install --lts. En Windows, nvm no funciona: instala NVM for Windows con winget install nvm-windows y ejecuta nvm install lts. Los dos instalan Node.js 26, la versión LTS actual, y te dejan cambiar de versión con nvm use.

NVM (Node Version Manager) instala varias versiones de Node.js en el mismo equipo y cambia de una a otra con un comando. Así cada proyecto usa la versión que necesita y nunca tienes que desinstalar Node.js para probar otra.

Hay dos herramientas con casi el mismo nombre:

• nvm (el proyecto nvm-sh) para macOS, Linux y WSL. La última versión es la 0.41.0, del 4 de noviembre de 2026.
• NVM for Windows, un proyecto distinto con comandos parecidos. La última versión es la 2.0.1, del 2 de octubre de 2026.

Los mismos tres pasos en cualquier sistema: instalar NVM, instalar Node.js LTS y cambiar de versión con nvm use.

NVM de un vistazo

Instalar NVM en Windows

1. Si ya tienes Node.js instalado, desinstálalo antes en Configuración > Aplicaciones. El equipo de NVM for Windows lo recomienda para evitar conflictos.
2. Abre PowerShell e instala NVM for Windows:

winget install nvm-windows

También puedes descargar el instalador, nvm-2.0.1-x64-setup.exe (o arm64 si tu equipo tiene procesador ARM), desde la página de versiones y ejecutarlo. La versión 2 se instala para tu usuario, así que no necesitas una terminal de administrador.

3. Abre una terminal nueva e instala Node.js:

nvm install lts
nvm use lts
node -v

El proceso completo, con la actualización desde la versión 1 y los errores habituales, está en cómo instalar NVM en Windows.

Instalar NVM en macOS

1. Abre la Terminal y ejecuta el script oficial:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash

2. Cierra la Terminal, abre otra y compruébalo:

command -v nvm

Si responde nvm, ha funcionado. macOS usa zsh, y el script añade nvm a ~/.zshrc. Si ese archivo no existe, el script no puede añadirlo: créalo con touch ~/.zshrc y vuelve a ejecutar el script.

El equipo de nvm no da soporte a la instalación con Homebrew, así que usa el script. Más detalles en cómo instalar NVM en Mac.

Instalar NVM en Linux

1. Comprueba que tienes curl (en Ubuntu, sudo apt install curl) y ejecuta el script:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash

Si prefieres wget: wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh | bash.

2. Carga nvm en la terminal actual, o abre una nueva:

source ~/.bashrc
command -v nvm

Los mismos pasos sirven en WSL dentro de Windows. La guía completa, con Ubuntu, Debian, Fedora y los errores habituales, está en cómo instalar NVM en Linux.

Instalar Node.js y cambiar de versión con NVM

Los comandos son casi iguales en todos los sistemas:

Comprueba la versión activa cuando quieras con node -v y npm -v.

¿Qué versión de Node.js instalar?

Node.js 27 está en pruebas y su versión estable está prevista para abril de 2027.

Instalar y usar NVM con IA

Un asistente de IA como ChatGPT, Claude o GitHub Copilot puede guiarte en la instalación y leer los errores por ti. Dale tu sistema, tu terminal y el texto exacto que ves. Estos tres prompts están listos para copiar.

1. Pide los pasos exactos para tu equipo

Uso [Windows 11 con PowerShell / macOS 15 con zsh / Ubuntu 24.04 con bash].
Quiero instalar NVM y Node.js 26 LTS, y mantener Node 24 para un proyecto antiguo.
[Ya tengo / No tengo] Node.js instalado.
Dame los comandos uno a uno, explícame qué hace cada uno
y cómo comprobar que ha funcionado.

2. Arregla "nvm: command not found"

He instalado nvm con el script oficial, pero la terminal dice "nvm: command not found".
Mi sistema es [macOS 15 / Ubuntu 24.04] y mi shell es [zsh / bash].
Esta es la salida de: ls -a ~ | grep -E "bashrc|zshrc|profile"
[pega la salida]
Dime qué archivo debe cargar nvm y qué líneas necesita.

3. Pasa un proyecto a una nueva versión de Node.js

Mi proyecto funciona con Node.js [20] y quiero pasarlo a Node.js 26 LTS con nvm.
Este es mi package.json: [pégalo]
Dime cómo instalar la 26, qué dependencias pueden fallar y cómo guardar
la versión en un archivo .nvmrc para que mi equipo use la misma.

Lee cada comando antes de ejecutarlo, sobre todo los que cambian tu perfil de la terminal o tu PATH.

Usa .nvmrc para fijar la versión de Node.js de un proyecto

Un archivo .nvmrc en la raíz del proyecto indica qué versión de Node.js necesita. Quien lo clone ejecuta un comando y tiene la versión correcta.

En macOS y Linux:

node -v > .nvmrc
nvm use

nvm use sin versión lee .nvmrc. Si esa versión no está instalada, nvm install la instala.

En Windows, NVM for Windows 2 escribe el archivo por ti con nvm pin, por ejemplo nvm pin 26.

Sube .nvmrc a tu repositorio para que todo el equipo trabaje con la misma versión.

Para instalar una versión nueva y llevarte tus paquetes globales, usa nvm install 26 --reinstall-packages-from=24 en macOS y Linux, o nvm install 26 --copy-from=24.22.2 en Windows, con la versión antigua exacta que muestra nvm list.

Errores frecuentes al instalar NVM

Guías relacionadas

• Cómo instalar NVM en Windows
• Cómo instalar NVM en Linux
• Cómo instalar NVM en Mac
• Cómo instalar Git en Windows, macOS y Linux
• Cómo actualizar Python en la terminal