Back

Cómo Cambiar Versiones de Node.js en Linux usando NVM (Guía Paso a Paso)

Cómo Cambiar Versiones de Node.js en Linux usando NVM (Guía Paso a Paso)

Gestionar diferentes versiones de Node.js puede volverse complicado, especialmente si trabajas en múltiples proyectos que requieren su propia configuración de Node.js. Node Version Manager (NVM) facilita el cambio entre versiones de Node.js en Linux de manera sencilla y limpia. En esta guía, aprenderás exactamente cómo instalar NVM, cambiar versiones de Node, establecer valores predeterminados y resolver rápidamente problemas comunes.

Puntos Clave

  • NVM ayuda a gestionar múltiples versiones de Node.js sin conflictos.
  • Siempre ejecuta comandos de NVM y Node.js sin sudo para evitar problemas de permisos.

Paso 1: Instalar NVM en Linux

Ejecuta este comando en tu terminal:

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

Este script descarga e instala NVM automáticamente.

Verificar la Instalación

Recarga tu shell:

source ~/.bashrc  # Para usuarios de Bash
source ~/.zshrc   # Para usuarios de Zsh

Luego verifica la instalación de NVM:

nvm --version

Deberías ver el número de versión.

Solución de problemas de instalación

Si encuentras nvm: command not found:

  • Comprueba que tu ~/.bashrc o ~/.zshrc tenga estas líneas:
export NVM_DIR=""$HOME/.nvm""
[ -s ""$NVM_DIR/nvm.sh"" ] && . ""$NVM_DIR/nvm.sh""
  • Después de añadir estas líneas, recarga tu shell nuevamente.

Paso 2: Instalar y Gestionar Versiones de Node.js

Instalar la Última Versión de Node.js

Instala la última versión de Node.js:

nvm install node  # última versión
nvm install --lts # última versión de Soporte a Largo Plazo (LTS)

Instalar una Versión Específica de Node.js

Encuentra e instala una versión específica de Node.js (por ejemplo, 20.11.0):

nvm ls-remote
nvm install 20.11.0

Listar Versiones Instaladas

Comprueba las versiones de Node instaladas:

nvm ls

Paso 3: Cambiar Entre Versiones de Node.js

Cambia de versión de Node.js instantáneamente:

nvm use 20.11.0

Verifica la versión activa:

node -v

Establecer una Versión Predeterminada de Node.js

Establece la versión predeterminada de Node.js para nuevas terminales:

nvm alias default 20.11.0

Paso 4: Usar .nvmrc para Versiones Específicas de Proyecto

Crea un archivo .nvmrc en la carpeta de tu proyecto con la versión de Node dentro (por ejemplo, 20.11.0). Luego usa:

nvm use

NVM seleccionará automáticamente la versión del archivo .nvmrc.

Problemas Comunes y Soluciones Rápidas

La Versión de Node No Cambia

  • Asegúrate de no estar usando una versión de Node.js instalada en el sistema por error.
  • Ejecuta which node para confirmar que Node gestionado por NVM está activo.
  • Nunca uses sudo para comandos de NVM o para instalar paquetes npm.

Paquetes Globales de npm Desaparecen Después de Cambiar Versiones

Cada versión de Node.js gestiona sus propios paquetes globales de npm. Para migrar paquetes globales:

nvm install 20 --reinstall-packages-from=18

Reemplaza ""18"" con la versión de Node desde la que quieres migrar.

Actualizar NVM

Ejecuta el script de instalación nuevamente para actualizar NVM sin problemas:

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

Esto actualiza NVM sin afectar las versiones de Node instaladas.

Conclusión

Usar NVM simplifica significativamente la gestión de múltiples entornos de Node.js. Permite cambios rápidos, evita conflictos de versiones y mantiene fluido tu flujo de trabajo de desarrollo en Linux.

Preguntas Frecuentes

No. NVM instala las versiones de Node.js en tu directorio personal, por lo que no se necesitan permisos de root (`sudo`) y no deberían usarse.

NVM funciona perfectamente en macOS. Los usuarios de Windows deberían usar NVM for Windows, una herramienta similar pero separada.

Asegúrate de que las líneas de configuración de NVM estén en tu perfil de shell (`~/.bashrc`, `~/.zshrc`), luego recarga el shell o reinicia tu terminal.

Cada sesión de terminal puede tener una versión activa diferente de Node.js gestionada por NVM, pero una sola sesión solo puede ejecutar una versión a la vez.

Listen to your bugs 🧘, with OpenReplay

See how users use your app and resolve issues fast.
Loved by thousands of developers