Cómo instalar y configurar Node.js en Ubuntu con nodenv

Publicado: at 06:00

Cómo instalar y configurar Node.js en Ubuntu con nodenv

Node.js es un entorno de ejecución para JavaScript construido con el motor de JavaScript V8 de Chrome. Es ampliamente utilizado para desarrollar aplicaciones web, APIs y herramientas de desarrollo. A menudo, como desarrolladores, necesitamos trabajar con múltiples versiones de Node.js para diferentes proyectos. nodenv es una herramienta que facilita la instalación y gestión de múltiples versiones de Node.js en tu sistema. En este tutorial, aprenderás cómo instalar y configurar Node.js en Ubuntu y Windows Subsystem for Linux (WSL) utilizando nodenv.

Table of Contents

Open Table of Contents

Introducción

Nodenv es una herramienta de línea de comandos que te permite instalar fácilmente múltiples versiones de Node.js y alternar entre ellas. Esto es especialmente útil cuando trabajas en proyectos que requieren versiones específicas de Node.js.

Requisitos previos

1. Instalar las dependencias necesarias

Antes de instalar nodenv, necesitamos instalar varias dependencias que son necesarias para compilar e instalar diferentes versiones de Node.js.

Ejecuta el siguiente comando en la terminal:

sudo apt update && sudo apt install -y \
git-core curl build-essential libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev libncursesw5-dev \
libncurses5-dev libffi-dev liblzma-dev libgdbm-dev \
libnss3-dev libtool libyaml-dev pkg-config \
autoconf automake

Explicación:

2. Instalar nodenv

Clona el repositorio de nodenv en tu directorio home:

git clone https://github.com/nodenv/nodenv.git ~/.nodenv

3. Configurar las variables de entorno para nodenv

Para que nodenv funcione correctamente, debes agregarlo a tu variable PATH y configurar el entorno en tus archivos de inicio de shell. Es recomendable utilizar el archivo ~/.zprofile para las configuraciones que deben cargarse al iniciar sesión en Zsh.

3.1. Crear o editar el archivo ~/.zprofile

Abre el archivo ~/.zprofile con tu editor preferido (si no existe, se creará):

nano ~/.zprofile

3.2. Añadir las configuraciones de nodenv

Agrega las siguientes líneas al archivo ~/.zprofile:

# Configuración de nodenv
export PATH="$HOME/.nodenv/bin:$PATH"
eval "$(nodenv init -)"

Explicación:

Guarda los cambios y cierra el editor (en nano, presiona Ctrl + O para guardar y Ctrl + X para salir).

3.3. Aplicar los cambios

Recarga tu shell para aplicar los cambios:

source ~/.zshrc

Aveces aunque corras el comando no te dejara usar nodenv, si esto ocurre simplemente cierra y vuelve a abrir la terminal.

Aclaración

Si estás utilizando Bash en lugar de Zsh, puedes añadir las configuraciones a ~/.bashrc en lugar de ~/.zprofile.

4. Instalar node-build

node-build es un plugin para nodenv que te permite instalar versiones específicas de Node.js.

Clona el repositorio de node-build en el directorio de plugins de nodenv:

git clone https://github.com/nodenv/node-build.git "$(nodenv root)"/plugins/node-build

5. Configurar las variables de entorno para node-build

Para que node-build funcione correctamente, debes agregarlo a tu variable PATH y configurar el entorno en tus archivos de inicio de shell. Es recomendable utilizar el archivo ~/.zprofile para las configuraciones que deben cargarse al iniciar sesión en Zsh.

5.1. Crear o editar el archivo ~/.zprofile

Abre el archivo ~/.zprofile con tu editor preferido:

nano ~/.zprofile

5.2. Añadir las configuraciones de node-build

Agrega la siguiente línea al archivo ~/.zprofile:

export PATH="$HOME/.nodenv/plugins/node-build/bin:$PATH"

Explicación:

Tu archivo ~/.zprofile debería verse así:

# Configuración de nodenv
export PATH="$HOME/.nodenv/bin:$PATH"
export PATH="$HOME/.nodenv/plugins/node-build/bin:$PATH"
eval "$(nodenv init -)"

Guarda los cambios y cierra el editor (en nano, presiona Ctrl + O para guardar y Ctrl + X para salir).

5.3. Aplicar los cambios

Recarga tu shell para aplicar los cambios:

source ~/.zshrc

O simplemente cierra y vuelve a abrir la terminal.

Aclaración

Si estás utilizando Bash en lugar de Zsh, puedes añadir las configuraciones a ~/.bashrc en lugar de ~/.zprofile.

6. Instalar versiones de Node.js con nodenv

6.1. Listar las versiones de Node.js disponibles

Puedes ver una lista de todas las versiones de Node.js disponibles para instalar:

nodenv install --list

Esto mostrará una lista de versiones que puedes instalar, incluyendo versiones LTS y actuales.

6.2. Instalar una versión específica de Node.js

Por ejemplo, para instalar Node.js 20.17.0:

nodenv install 20.17.0

Nota: La instalación puede tardar varios minutos, ya que nodenv compila Node.js desde el código fuente.

6.3. Establecer la versión global de Node.js

Para establecer la versión instalada como la versión global predeterminada:

nodenv global 20.17.0

Verifica la versión de Node.js:

node -v

Deberías ver:

v20.17.0

También verifica la versión de npm:

npm -v

Solución de problemas comunes

nodenv no se carga correctamente

Si después de reiniciar tu terminal, nodenv no funciona, verifica que las líneas de configuración estén correctamente añadidas en ~/.zshrc o ~/.bashrc. Asegúrate de que no haya errores tipográficos y que las rutas sean correctas.

Error al instalar una versión de Node.js

Si encuentras errores al instalar una versión de Node.js, asegúrate de que tienes instaladas las dependencias necesarias para compilar Node.js.

Puedes instalar las dependencias con:

sudo apt install -y build-essential libssl-dev

Actualizar nodenv y sus plugins

Para mantener nodenv y sus plugins actualizados, puedes ejecutar:

cd ~/.nodenv && git pull
cd "$(nodenv root)"/plugins/node-build && git pull

Vídeo Tutorial

Si eres una persona visual, aquí tienes un vídeo tutorial que te guiará a través de los pasos para instalar y configurar Node.js con nodenv en Ubuntu y WSL:

En este vídeo se cubren todos los pasos detallados anteriormente, además de consejos adicionales para gestionar tus versiones de Node.js con nodenv.

Conclusión

Has instalado y configurado con éxito Node.js utilizando nodenv en tu sistema Ubuntu o WSL. Ahora puedes gestionar múltiples versiones de Node.js de manera eficiente, lo que es esencial para trabajar en diferentes proyectos con requisitos específicos.

¡Disfruta de tu entorno de desarrollo de Node.js mejorado y sigue explorando las posibilidades que nodenv ofrece!