Instalar Node.js con fnm

fnm hace que instalar y gestionar versiones de Node.js sea simple y rápido. Esta guía detallará cómo usar fnm para instalar Node.js.

Inicio Rápido

Instalar Última Versión LTS

fnm install --lts

Instalar Última Versión

fnm install --latest

Instalar Versión Específica

fnm install 20
fnm install 18.17.0

Métodos de Instalación Explicados

Instalar Versión LTS

Las versiones LTS (Soporte a Largo Plazo) de Node.js son recomendadas para entornos de producción:

# Instalar última versión LTS
fnm install --lts

# Instalar versión LTS específica
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium  # Node.js 16.x

Nombres en Código de Versiones LTS:

Nombre en Código	Versión	Estado
Iron	20.x	LTS Activo
Hydrogen	18.x	Mantenimiento
Gallium	16.x	Fin de Vida Útil

Instalar Versión Específica

# Instalar versión mayor (selecciona automáticamente la última versión menor)
fnm install 20

# Instalar versión específica
fnm install 20.10.0

# Instalar versión antigua
fnm install 14.21.3

Instalar Usando Archivo de Versión

Crear un archivo .node-version o .nvmrc en el directorio del proyecto:

# Crear archivo .node-version
echo "20" > .node-version

# fnm leerá e instalará automáticamente
fnm install

Usar Después de la Instalación

Cambiar a Versión Instalada

# Usar versión específica
fnm use 20

# Si la versión no está instalada, auto instalar luego usar
fnm use 18 --install-if-missing

Establecer Versión Predeterminada

# Establecer versión predeterminada
fnm default 20

# Ver versión predeterminada actual
fnm default

Usar Inmediatamente Después de la Instalación

# Instalar y cambiar a la versión inmediatamente
fnm install 20 --use

Ver Versiones Disponibles

Ver Versiones Remotas

# Listar todas las versiones disponibles
fnm list-remote

# Listar solo versiones LTS
fnm list-remote --lts

# Filtrar versiones específicas
fnm list-remote --filter=18

# Ver últimas versiones
fnm list-remote --latest

Ver Versiones Instaladas Localmente

fnm list

Ejemplo de salida:

* v20.10.0 default
  v18.19.0
  v16.20.2

Usar Mirror para Descarga Más Rápida

En China continental, puedes usar un mirror para acelerar las descargas:

# Establecer variable de entorno del mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# O especificar durante la instalación
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Mirrors comunes:

Fuente de Mirror	URL
npmmirror	https://npmmirror.com/mirrors/node
Universidad de Tsinghua	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Soporte de Corepack

fnm soporta Corepack, que puede habilitar automáticamente Yarn y pnpm:

# Habilitar Corepack durante la instalación
fnm install 20 --corepack-enabled

# O establecer variable de entorno
export FNM_COREPACK_ENABLED=true
fnm install 20

Mejores Prácticas de Gestión de Versiones

Gestión de Versiones a Nivel de Proyecto

Crear un archivo .node-version en el directorio raíz del proyecto:

# Especificar versión mayor
echo "20" > .node-version

# O especificar versión exacta
echo "20.10.0" > .node-version

Combinado con la opción --use-on-cd, cambia automáticamente las versiones al entrar al directorio:

# Añadir a la configuración del Shell
eval "$(fnm env --use-on-cd)"

Desarrollo con Múltiples Versiones

# Instalar múltiples versiones
fnm install 20
fnm install 18
fnm install 16

# Cambiar entre diferentes proyectos
cd project-a && fnm use 20
cd project-b && fnm use 18

Usar Alias

# Establecer alias
fnm alias 20 default
fnm alias 18 legacy

# Cambiar usando alias
fnm use default
fnm use legacy

Problemas Comunes

Instalación Fallida

Si la instalación falla, verifica:

1. Si la conexión de red es normal
2. Si necesitas configurar un mirror
3. Si hay suficiente espacio en disco

# Reintentar usando mirror
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

El Cambio de Versión No Funciona

Asegúrate de que el Shell esté configurado correctamente:

# Verificar versión actual
fnm current

# Verificar ruta de node
which node

Limpiar Versiones Antiguas

# Ver versiones instaladas
fnm list

# Desinstalar versiones no necesarias
fnm uninstall 16.20.2

Enlaces Relacionados

• Instalar fnm - Instalar fnm
• Referencia de Comandos - Todos los detalles de comandos
• Gestión de Versiones - Guía detallada de gestión de versiones