NVM en Node.js para cambiar de versión sin conflictos

8 de noviembre de 2026

Logos de Node.js y JavaScript, con el logo de nvm debajo. El fondo tiene un patrón sutil de pingüinos.

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.

Instrucciones para instalar y gestionar versiones de Node.js con nvm. Muestra comandos para instalar, listar y cambiar versiones.

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.

Por ejemplo, si el archivo contiene 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.

Preguntas frecuentes

En macOS, Linux y WSL se utiliza nvm-sh. En Windows nativo, desde PowerShell o el Símbolo del sistema, se suele usar nvm-windows, que tiene su propio instalador y comandos. Si trabajas dentro de WSL, instala nvm-sh en ese entorno Linux, no como si fuera Windows nativo.

Ejecuta nvm install 20 para instalar una versión de la rama 20 y nvm use 20 para activarla en la terminal actual. Comprueba el resultado con node -v. Para ver las versiones instaladas puedes usar nvm ls, y para establecer la predeterminada en nuevas sesiones, nvm alias default 20.

El archivo .nvmrc, situado normalmente en la carpeta raíz, indica la versión de Node.js que espera el proyecto. En nvm-sh puedes entrar en esa carpeta y ejecutar nvm use; si esa versión no está instalada, el comando puede avisarte. El archivo no siempre cambia la versión automáticamente, porque eso depende de la configuración de la terminal.

Comprueba la versión activa con nvm current y abre una terminal nueva para que cargue la configuración. Puede haber otra instalación de Node.js en el PATH o una terminal del editor con un entorno distinto; cierra y vuelve a abrir el editor y verifica allí con node -v. Si desapareció un paquete global de npm, activa la versión de Node.js a la que estaba asociado y comprueba si debes instalarlo de nuevo.
Calificar artículo

Promedio: 4.8 / 5 · 6 calificaciones

Etiquetas

nvm node.js npm wsl

Compartir artículo

Comentarios (0)
Añadir comentario