Cómo instalar NVM en Mac para gestionar Node.js

Cómo instalar NVM en Mac

Gestionar varias versiones de Node.js puede parecer un malabarismo, especialmente cuando un proyecto requiere la versión 14 y otro la versión 16 (si lo sabes, lo sabes). Créeme, lo he vivido: quedarme hasta tarde mirando mensajes de error porque a un proyecto no le «gustaba» mi versión actual de Node.js. Ahí es donde entra en juego NVM (Node Version Manager).

Tanto si eres un desarrollador que trabaja en proyectos heredados, como si estás experimentando con las últimas funciones o simplemente estás aprendiendo Node.js por primera vez, NVM te garantiza que seguirás siendo productivo. Piensa en él como tu «máquina del tiempo» de Node.js (también conocido como Node version manager Mac), que te permite saltar entre versiones.

Si te identificas con esto, déjame ser tu guía (piensa en Sam y Frodo) en el viaje para instalar NVM en Mac. Te lo explicaré todo paso a paso para que no te parezca un camino a Mordor, te lo prometo.

Requisitos previos para instalar NVM en Mac

Antes de intentar instalar NVM en macOS, repasemos rápidamente algunas cosas para que la instalación sea fluida.

Esto es lo que necesitarás hoy:

  • Terminal. Es tu herramienta imprescindible para ejecutar comandos. En el último macOS Sequoia y en versiones anteriores, puedes abrir Terminal pulsando Comando + Espacio, escribiendo «Terminal» y pulsando Retorno.
  • Conocimientos básicos de Terminal. No te asustes por la palabra «básicos». Si sabes escribir comandos y pulsar Intro, ya estás listo. Te guiaré paso a paso.
  • Homebrew o MacPorts (opcional). Son gestores de paquetes para instalar software como NVM. Piensa en ellos como tiendas de aplicaciones para tu Terminal. Aunque son opcionales para esta guía, los gestores de paquetes como Homebrew pueden ahorrarte mucho tiempo al automatizar las descargas, instalaciones y actualizaciones. Si aún no tienes uno, instalar Homebrew en un Mac es una buena opción: es sencillo, fiable y, sinceramente, mucho más fácil que descargar cosas manualmente.

Además, echa un vistazo a cómo desinstalar Node.js en un Mac.

Consejo

Si los comandos de Terminal te intimidan, prueba CoreShell. Hace que trabajar con la línea de comandos sea mucho más sencillo, especialmente si gestionas varias conexiones SSH. La compatibilidad con OpenSSH te permite acceder a opciones avanzadas como proxy jump, post command y agent forwarding.

Instalar NVM con curl o wget

A la hora de instalar NVM, curl (una herramienta común que ya viene instalada en la mayoría de los Mac) o wget (otra herramienta para descargar archivos) son, sin duda, los métodos más populares y sencillos. Este fue el método que probé primero porque, sinceramente, me pareció rápido y tenía prisa por solucionar un problema con Node.js en un proyecto.

Nota: ¿curl o wget? Utiliza el que tengas disponible. curl viene preinstalado en macOS, pero puedes instalar wget a través de Homebrew (brew install wget) si es necesario. Si no estás seguro de qué shell estás utilizando, ejecuta echo $SHELL. A partir de macOS Catalina, Zsh es el shell predeterminado, por lo que la mayoría de los usuarios editarán ~/.zshrc.

Comienza con Terminal

Pero antes de sumergirnos en el proceso, comencemos con un flujo para Terminal, especialmente si eres nuevo en macOS Sequoia. No es nada difícil.

Esto es lo que debes hacer:

  1. Presiona Comando + Espacio y escribe «Terminal» para abrirlo.
  2. Instala NVM:
  • Si utilizas curl, escribe curl -o- https://raw.githubusercontent…. | bash
  • Si utilizas wget, escribe wget -qO- https://raw.githubusercontent…. | bash
  • Añade las siguientes líneas al archivo de configuración del shell para asegurarte de que NVM se carga cada vez que abres un Terminal:
  • Para Zsh (predeterminado en las versiones más recientes de macOS), escribe nano ~/.zshrc
  • Para Bash (utilizado en versiones anteriores de macOS), escribe nano ~/.bash_profile
  • Añade las siguientes líneas al archivo: export NVM_DIR=”$HOME/.nvm”
  • [ -s «$NVM_DIR/nvm.sh» ] && . «$NVM_DIR/nvm.sh».
  • Activa el perfil de actualización y escribe source ~/.zshrc (sustituye ~/.zshrc por ~/.bash_profile si utilizas Bash).
  • Comprueba si NVM se ha instalado correctamente y escribe nvm –version.

Si ves un número de versión, ¡enhorabuena! Has instalado NVM.

Experiencia personal: cuando instalé NVM por primera vez, me encontré con un problema: faltaban las herramientas de línea de comandos de Xcode. Una solución rápida: xcode-select –install. Después de ejecutar el comando curl, añadir NVM a mi perfil de shell y aplicar los cambios con source ~/.zshrc, todo funcionó perfectamente.

Lee también:

Instalar NVM con Homebrew

Si te gusta ahorrar tiempo y hacerte la vida más fácil, Homebrew es la mejor opción para instalar NVM. Es como la navaja suiza de las herramientas de macOS: sencilla, fiable y se encarga de todo el trabajo sucio por ti. Si la idea de copiar scripts complicados te hace querer salir corriendo (a mí me pasa lo mismo), Homebrew es tu nuevo mejor amigo. Hace las cosas rápidamente y te deja más tiempo libre.

Me encantó Homebrew desde la primera vez que lo usé. Fue como encontrar un truco para mi Mac. Créeme, una vez que lo pruebes, te preguntarás cómo has podido vivir sin él.

A continuación te explicamos cómo instalar NVM con Homebrew:

  1. Abre Terminal e instala Homebrew (si aún no lo tienes instalado) escribiendo /bin/bash -c «$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)».
  2. Instala NVM con Homebrew escribiendo brew install nvm.
  3. Crea el directorio NVM y carga NVM escribiendo mkdir ~/.nvm export NVM_DIR=”$HOME/.nvm” . «$(brew –prefix nvm)/nvm.sh».
  4. Añade las siguientes líneas al archivo de configuración de tu shell para asegurarte de que NVM se carga cada vez que abres un terminal:
  • Para Zsh (predeterminado en las versiones más recientes de macOS), escribe nano ~/.zshrc
  • Para Bash (utilizado en versiones anteriores de macOS), escribe nano ~/.bash_profile
  • Añade las siguientes líneas al archivo: export NVM_DIR=”$HOME/.nvm” [ -s «$NVM_DIR/nvm.sh» ] && . «$NVM_DIR/nvm.sh».
  • Activa el perfil de actualización y escribe source ~/.zshrc (sustituye ~/.zshrc por ~/.bash_profile si utilizas Bash).
  • Comprueba si NVM se ha instalado correctamente y escribe nvm –version.

Si aparece el número de versión, ¡enhorabuena! Has instalado NVM correctamente con Homebrew.

Una vez instalado NVM, te recomiendo que pruebes tu código Node.js con CodeRunner. Es un IDE fantástico que admite múltiples lenguajes de programación y hace que la depuración de tu código sea muy intuitiva. Es mi herramienta preferida para pruebas rápidas. Por ejemplo, si estás trabajando en un proyecto en el que necesitas probar diferentes versiones de Node.js, como asegurarte de que funciona bien con Node.js 14 y 18, puedes cambiar fácilmente entre versiones utilizando NVM y ejecutar tu código directamente en CodeRunner.

Usar MacPorts para instalar NVM

Si estás familiarizado con MacPorts, es una opción sólida para instalar NVM. Simplifica las cosas y elimina el estrés de gestionar el software en tu Mac. Lo he usado antes en versiones anteriores de macOS y, aunque no es la herramienta más bonita, es fiable y realmente te puede ayudar con lo que necesitas. A veces, eso es lo único que importa.

A continuación te explicamos cómo puedes utilizar MacPorts para instalar NVM:

  1. Instala y abre MacPorts utilizando la versión compatible con macOS.
  2. Abre Terminal y escribe sudo port install nvm para instalar NVM a través de MacPorts.
  3. Carga NVM actualizando tu perfil de shell. Añade el siguiente comando a ~/.zshrc o ~/.bash_profile: export NVM_DIR=”$HOME/.nvm” [ -s «$NVM_DIR/nvm.sh» ] && . «$NVM_DIR/nvm.sh».
  4. Aplica los cambios ejecutando source ~/.zshrc.
  5. Verifica la instalación con: nvm –version.

Si ves un número de versión, ¡ya estás listo para empezar!

Consejo

Yo organizo mis fragmentos de comandos con SnippetsLab. Es perfecto para almacenar y reutilizar tus comandos de Terminal sin tener que rebuscar en archivos antiguos. También te permite acceder a tus fragmentos directamente desde el menú superior, sin necesidad de abrir la aplicación. Muy cómodo.

Instalar y gestionar varias versiones de Node.js con NVM

Aquí es donde NVM se convierte en un salvavidas. Recuerdo que trabajaba en dos proyectos al mismo tiempo (lo cual era habitual en mí): uno necesitaba Node.js 14 para garantizar la estabilidad y el otro requería Node.js 18 para utilizar las últimas funciones. Sin NVM, cambiar de versión era una pesadilla: había que desinstalar, reinstalar y rezar para que nada se estropeara o se perdiera en el proceso. Una vez que descubrí NVM, fue como quitarme un peso de encima.

Así es como puedes gestionar las versiones de Node.js sin esfuerzo:

  • Instala una versión específica. Supongamos que necesitas Node.js 14. Solo tienes que ejecutar nvm install 14 y NVM lo descargará y lo configurará. Es tan fácil como tomarte un café en tu cafetería favorita, sin dramas.
  • Cambia entre versiones. ¿Necesitas cambiar a Node.js 16? Solo tienes que ejecutar nvm use 16 y listo. Yo uso esta función constantemente cuando pruebo actualizaciones en un entorno sandbox.
  • Establece una versión predeterminada. ¿Cansado de escribir comandos cada vez? Usa nvm alias default 14 para que Node.js 14 sea tu versión predeterminada. De esta forma, se cargará automáticamente cuando abras Terminal, lo que es perfecto para proyectos a largo plazo.

Con NVM, puedes probar, depurar y ejecutar proyectos rápidamente en diferentes entornos Node.js sin sudar ni una gota. He ahorrado innumerables horas (y evitado muchos dolores de cabeza) al dejar que NVM se encargue de la gestión de versiones por mí.

Cómo instalar NVM en Mac: resumen

Gestionar Node.js en macOS es mucho más fácil con NVM. Tanto si lo instalas con curl, Homebrew o MacPorts, el proceso es sencillo y flexible. Una vez instalado, cambiar entre versiones de Node.js es cuestión de segundos, lo que te ahorra dolores de cabeza por problemas de compatibilidad.

Las herramientas mencionadas, como CoreShell, CodeRunner y SnippetsLab, facilitan aún más el proceso y están disponibles en Setapp. Con una prueba gratuita de 7 días, puedes explorar estas aplicaciones y más de 250 aplicaciones para macOS e iOS. No esperes más: prueba Setapp y simplifica tu experiencia de programación.

Preguntas frecuentes

¿Cómo puedo saber si NVM está instalado en mi Mac?

Para saber si NVM está instalado en tu Mac, ejecuta nvm –version en Terminal. Si aparece un número de versión, NVM está instalado.

¿Cómo instalo NVM en Zsh?

Para instalar NVM en Zsh:

  1. Ejecuta el siguiente comando en Terminal para instalar NVM: curl -o- https://raw.githubusercontent…. | bash.
  2. Abre tu archivo de configuración de Zsh: nano ~/.zshrc.
  3. Añade las siguientes líneas al final del archivo: export NVM_DIR=”$HOME/.nvm”
  4. [ -s «$NVM_DIR/nvm.sh» ] && . «$NVM_DIR/nvm.sh».
  5. Vuelve a cargar la configuración de Zsh ejecutando: source ~/.zshrc.
  6. Confirma que NVM está instalado y funciona escribiendo: nvm –version.

¿Cómo configuro la ruta para NVM en Mac?

Para configurar la ruta para NVM en Mac, añade export NVM_DIR=”$HOME/.nvm [ -s «$NVM_DIR/nvm.sh» ] && . «$NVM_DIR/nvm.sh» a tu perfil de shell y ejecuta source ~/.zshrc en Terminal.