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

Node.js es un entorno de ejecución para JavaScript ampliamente utilizado para desarrollo backend, herramientas CLI y APIs. Si trabajas en varios proyectos, es probable que necesites manejar diferentes versiones de Node.js. Para eso está nodenv: una herramienta simple y eficiente para instalar y gestionar múltiples versiones.

Open Table of Contents

🔧 ¿Qué necesitas?
1. Instala las dependencias necesarias
2. Instala nodenv
3. Configura tu entorno
4. Instala node-build (plugin de nodenv)
5. Verifica versiones disponibles de Node.js
6. Instala una versión específica de Node.js
🛠️ ¿Problemas comunes?
- nodenv no se reconoce
- Error de compilación
🔄 Actualiza nodenv y node-build
🚀 Conclusión
📚 Recursos adicionales

🔧 ¿Qué necesitas?

Ubuntu 18.04+ o WSL en Windows 10/11
Conexión a internet
Acceso a sudo
Git instalado

1. Instala las dependencias necesarias

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

2. Instala nodenv

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

3. Configura tu entorno

Agrega estas líneas a tus archivos de entorno ~/.bashrc, ~/.zshrc, ~/.profile o ~/.zprofile, según tu shell:

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

Aplica los cambios:

exec "$SHELL"

4. Instala node-build (plugin de nodenv)

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

5. Verifica versiones disponibles de Node.js

nodenv install --list

Deberías ver una lista de versiones de Node.js disponibles. Elige la versión que necesites (por ejemplo 22.17.0).

6. Instala una versión específica de Node.js

Ejemplo:

nodenv install 22.17.0
nodenv global 22.17.0

Verifica:

node -v
npm -v

Deberías ver algo como:

v22.17.0
10.9.2

🛠️ ¿Problemas comunes?

nodenv no se reconoce

Asegúrate de haber agregado correctamente las líneas en ~/.zshrc o ~/.bashrc.

Error de compilación

Reinstala dependencias críticas:

sudo apt install -y build-essential libssl-dev

🔄 Actualiza nodenv y node-build

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

🚀 Conclusión

Ahora tienes un entorno Node.js completamente funcional con nodenv.

✅ Puedes:

Instalar y alternar entre versiones de Node.js
Usar configuraciones por proyecto con .node-version
Mantener tu entorno limpio y reproducible