Tutorial Node: Gestor de versiones nvm

Instalación de nvm

Node Version Manager (nvm) es una herramienta esencial que permite instalar y gestionar múltiples versiones de Node.js en un mismo sistema. Esta capacidad resulta fundamental cuando trabajas en diferentes proyectos que requieren versiones específicas de Node.js, o cuando necesitas probar tu código con distintas versiones del runtime.

La instalación de nvm en Windows requiere una variante específica llamada nvm-windows, ya que la versión original está diseñada para sistemas Unix. Esta herramienta mantiene la misma funcionalidad core pero está adaptada para el entorno Windows.

Descarga e instalación

Para instalar nvm en Windows, necesitas descargar nvm-windows desde su repositorio oficial en GitHub. El proceso de instalación es directo y no requiere configuraciones complejas.

1 - Accede al repositorio oficial:

Visita https://github.com/coreybutler/nvm-windows y dirígete a la sección de releases para descargar la última versión estable.

2 - Descarga el instalador:

Busca el archivo nvm-setup.exe en la última release disponible. Este instalador incluye todos los componentes necesarios para el funcionamiento de nvm.

3 - Ejecuta la instalación:

Ejecuta el archivo descargado con permisos de administrador. El instalador te guiará a través del proceso de configuración, donde podrás seleccionar la ruta de instalación y configurar las variables de entorno automáticamente.

Configuración post-instalación

Una vez completada la instalación, es importante verificar que nvm esté correctamente configurado en tu sistema. El instalador debería haber añadido las rutas necesarias a las variables de entorno PATH automáticamente.

Verificación de la instalación:

Abre una nueva ventana de Command Prompt o PowerShell como administrador y ejecuta:

nvm version

Si la instalación fue exitosa, verás la versión de nvm instalada en tu sistema. En caso de no reconocer el comando, será necesario reiniciar tu terminal o incluso tu sistema para que las variables de entorno se actualicen correctamente.

Consideraciones importantes

Durante la instalación, nvm-windows creará una estructura de directorios específica donde almacenará las diferentes versiones de Node.js. Por defecto, esta estructura se ubica en C:\Users\[usuario]\AppData\Roaming\nvm, aunque puedes modificar esta ubicación durante el proceso de instalación.

Es fundamental entender que una vez instalado nvm, no debes instalar Node.js directamente desde su sitio web oficial, ya que esto puede generar conflictos con la gestión de versiones. En su lugar, utilizarás los comandos de nvm para instalar y gestionar todas las versiones de Node.js que necesites.

La instalación de nvm también incluye la capacidad de gestionar npm automáticamente, ya que cada versión de Node.js viene con su propia versión correspondiente de npm. Esto significa que cuando cambies entre versiones de Node.js, también estarás cambiando la versión de npm asociada.

Comandos de nvm

Una vez que tienes nvm instalado en tu sistema Windows, puedes aprovechar su amplio conjunto de comandos para gestionar eficientemente las versiones de Node.js. Estos comandos te permiten instalar, cambiar, listar y eliminar versiones según las necesidades de tus proyectos.

Comandos básicos de gestión

El comando más fundamental es nvm list available, que muestra todas las versiones de Node.js disponibles para instalación. Este comando consulta el repositorio oficial y presenta una lista organizada de las versiones LTS y actuales:

nvm list available

Para instalar una versión específica de Node.js, utiliza el comando nvm install seguido del número de versión:

nvm install 22.0.0

También puedes instalar la última versión LTS disponible sin especificar el número exacto:

nvm install lts

Gestión de versiones activas

Una vez que tienes múltiples versiones instaladas, necesitas alternar entre ellas según el proyecto en el que estés trabajando. El comando nvm use te permite cambiar la versión activa:

nvm use 22.0.0

Para verificar qué versiones tienes instaladas en tu sistema, utiliza:

nvm list

Este comando mostrará todas las versiones instaladas localmente, marcando con un asterisco (*) la versión actualmente en uso.

Configuración de versión por defecto

Cuando abres una nueva terminal, nvm necesita saber qué versión de Node.js debe cargar automáticamente. Para establecer una versión por defecto, utiliza:

nvm alias default 22.0.0

Esto garantiza que cada nueva sesión de terminal inicie con la versión especificada, evitando tener que ejecutar nvm use manualmente cada vez.

Comandos de información y verificación

Para obtener información detallada sobre la versión actualmente en uso, incluyendo la ruta de instalación:

nvm current

Si necesitas conocer la ruta exacta donde está instalada una versión específica:

nvm which 22.0.0

Limpieza y mantenimiento

Cuando una versión de Node.js ya no es necesaria, puedes eliminarla para liberar espacio en disco:

nvm uninstall 20.0.0

Para reinstalar una versión (útil cuando hay problemas con la instalación):

nvm reinstall-packages 22.0.0

Comandos avanzados

El comando nvm on y nvm off te permiten habilitar o deshabilitar temporalmente nvm sin desinstalarlo:

nvm on
nvm off

Para obtener ayuda completa sobre todos los comandos disponibles:

nvm --help

Flujo de trabajo típico

Un flujo de trabajo común al comenzar un nuevo proyecto sería:

1 - Verificar versiones disponibles:

nvm list available

2 - Instalar la versión LTS más reciente:

nvm install lts

3 - Activar la versión instalada:

nvm use lts

4 - Verificar que Node.js y npm están funcionando:

node --version
npm --version

Esta secuencia de comandos te asegura tener un entorno de desarrollo limpio y actualizado para comenzar cualquier proyecto Node.js. La flexibilidad de nvm te permite repetir este proceso con diferentes versiones según los requisitos específicos de cada proyecto.