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.