Al abrir un proyecto de Node.js, puede aparecer un error porque la versión instalada no coincide con la que necesita la aplicación. NVM suele resolver ese choque al permitirte instalar varias versiones de Node.js y cambiar entre ellas, aunque el comando y la instalación dependen del sistema operativo.

NVM te permite adaptar Node.js a cada proyecto
- NVM significa Node Version Manager y gestiona versiones de Node.js.
- nvm install instala una versión; nvm use la activa en la terminal.
- Un archivo .nvmrc puede indicar la versión que necesita un proyecto.
- En Windows se suele usar nvm-windows, una implementación distinta de nvm-sh.
Qué es NVM y por qué evita conflictos entre proyectos
Si una aplicación antigua deja de arrancar tras actualizar Node.js, el problema puede estar en la versión, no en el código. NVM es un gestor que permite mantener varias versiones de Node.js en el mismo equipo y activar la adecuada desde la terminal.
Node.js ejecuta JavaScript fuera del navegador; npm, que normalmente se instala junto con Node.js, permite gestionar paquetes para esas aplicaciones. La documentación oficial de Node.js sobre gestores de versiones señala que estas herramientas ayudan cuando distintos proyectos requieren versiones diferentes. Creo que esa es la utilidad más clara de NVM: evitar que actualizar un proyecto cambie sin querer el entorno de otro.
El comando cambia según uses macOS, Linux o Windows
El nombre puede despistar: nvm-sh y nvm-windows no son el mismo programa. El proyecto nvm-sh está pensado para shells compatibles en macOS, Linux y WSL; en Windows nativo, el proyecto habitual es nvm-windows, con instrucciones y comandos propios.
| Situación | Qué significa | Qué hacer |
|---|---|---|
| macOS, Linux o WSL | Corresponde la implementación nvm-sh. | Sigue sus instrucciones de instalación y usa sus comandos. |
| Windows en PowerShell o Símbolo del sistema | Corresponde nvm-windows, que tiene su propio instalador. | Consulta la documentación de nvm-windows, no ejecutes instrucciones de nvm-sh. |
| Windows con WSL | La terminal opera dentro del entorno Linux de WSL. | Instala y configura nvm-sh dentro de WSL, no como si fuera Windows nativo. |
Esta distinción evita un tropiezo frecuente: seguir una guía de macOS en PowerShell y concluir que NVM está roto. Primero identifica la terminal desde la que ejecutarás Node.js; el editor puede abrir una terminal distinta a la que usaste para instalarlo.
Instala y activa solo la versión que pide tu proyecto
Con nvm-sh ya instalado, los comandos básicos se entienden casi de un vistazo. Por ejemplo, nvm install 20 instala la rama 20 y nvm use 20 la activa en esa sesión de terminal; puedes comprobar la versión activa con node -v.
nvm install 20: instala una versión de la rama 20.nvm use 20: cambia la versión activa en la terminal actual.nvm ls: muestra las versiones instaladas.nvm alias default 20: selecciona la versión predeterminada para nuevas sesiones.
Los ejemplos usan la sintaxis de nvm-sh; nvm-windows tiene particularidades propias, así que sigue su documentación en Windows nativo. Tampoco conviene elegir automáticamente la versión más nueva: si el proyecto especifica otra, manda ese requisito.
Un archivo .nvmrc puede prevenir el cambio de versión equivocado
Un proyecto puede incluir un archivo llamado .nvmrc en su carpeta raíz para indicar qué versión de Node.js espera. En nvm-sh, al entrar en esa carpeta puedes ejecutar nvm use; si la versión indicada aún no está instalada, el comando puede avisar de que falta.
20, ese valor funciona como una pista compartida para el equipo y reduce las diferencias entre entornos. El archivo no siempre cambia la versión por sí solo: según la configuración de la terminal, puede ser necesario ejecutar el comando manualmente o añadir una automatización.
Si Node.js o npm no muestran la versión esperada
Cuando NVM parece instalado pero la terminal sigue ejecutando otra versión, suele haber una discrepancia de entorno: una instalación previa de Node.js, una sesión que no se ha reiniciado o un editor que conserva un PATH distinto. El PATH es la lista de ubicaciones donde el sistema busca programas al ejecutar un comando.
| Situación | Causa probable | Qué hacer |
|---|---|---|
nvm no se reconoce |
La terminal no ha cargado la configuración o se instaló la variante equivocada. | Abre una terminal nueva y confirma si trabajas en WSL o en Windows nativo. |
node -v muestra otra versión |
Hay otra instalación en el PATH o no se activó la versión esperada. | Ejecuta nvm current y revisa qué instalación encuentra la terminal. |
| Un comando global de npm ha desaparecido | Los paquetes globales pueden estar asociados a una versión concreta de Node.js. | Activa la versión correspondiente y comprueba si hace falta instalar de nuevo ese paquete global. |
| La terminal del editor se comporta distinto | El editor puede haber iniciado una sesión con otro PATH o shell. | Cierra y vuelve a abrir el editor después de configurar NVM y verifica allí node -v. |
Un detalle que suele sorprender: cambiar Node.js no garantiza que todos los paquetes instalados globalmente aparezcan en cada versión. Si una herramienta global deja de responder después del cambio, comprueba primero qué versión está activa, antes de reinstalar NVM o modificar el proyecto.
La elección sencilla es usar la versión que declara el proyecto
Para un equipo que trabaja con varios proyectos, combinar NVM con una versión indicada en .nvmrc ofrece una rutina clara: activas la versión esperada y verificas el resultado con node -v. Si solo tienes una aplicación y nunca necesitas probar compatibilidad, un gestor puede ser innecesario; instalar Node.js directamente puede bastar.
Mi criterio sería priorizar la versión declarada por el proyecto y no actualizar por impulso. Así, el entorno de desarrollo se mantiene más predecible y resulta más fácil detectar si un fallo viene del código, de npm o de una diferencia de versión.