Guía del Comando use de fnm

El comando fnm use se usa para cambiar la versión de Node.js actualmente utilizada.

Sintaxis del Comando

fnm use [OPCIONES] [VERSION]

Parámetros

VERSION

Especificar la versión de Node.js a la que cambiar:

# Cambiar a versión mayor
fnm use 20

# Cambiar a versión específica
fnm use 20.10.0

# Usar alias
fnm use default

# Sin versión especificada, lee del archivo de versión
fnm use

Opciones

--install-if-missing

Instalar automáticamente la versión si no está instalada:

fnm use 18 --install-if-missing

--silent-if-unchanged

No mostrar mensaje si la versión no cambia:

fnm use 20 --silent-if-unchanged

--node-dist-mirror

Usado con --install-if-missing para especificar mirror de descarga:

fnm use 18 --install-if-missing --node-dist-mirror=https://npmmirror.com/mirrors/node

--fnm-dir

Especificar directorio de instalación de fnm:

fnm use 20 --fnm-dir=/custom/path

--log-level

Establecer nivel de registro:

fnm use 20 --log-level=quiet

Ejemplos de Uso

Cambio Básico

# Cambiar a Node.js 20
fnm use 20

# Cambiar a Node.js 18.17.0
fnm use 18.17.0

Auto Instalar y Cambiar

# Instalar automáticamente si la versión no está instalada
fnm use 16 --install-if-missing

Cambiar Usando Alias

# Usar alias preestablecido
fnm use default
fnm use legacy

Modo Silencioso

# Usar en scripts para evitar salida innecesaria
fnm use 20 --silent-if-unchanged

Prioridad de Selección de Versión

Cuando no se especifica una versión, fnm busca en el siguiente orden:

1. Archivo .node-version
2. Archivo .nvmrc
3. Campo engines.node de package.json
4. Versión predeterminada

Diferencia con el Comando default

• fnm use - Cambia la versión para la sesión actual del Shell
• fnm default - Establece la versión predeterminada global

# Establecer versión predeterminada (afecta a nuevos terminales)
fnm default 20

# Cambiar versión temporalmente (solo terminal actual)
fnm use 18

Problemas Comunes

Versión No Instalada

# Mensaje de error
error: Can't find version 18.0.0

# Solución: Auto instalar
fnm use 18 --install-if-missing

La Versión de node No Cambia Después del Cambio

Asegúrate de que la configuración del Shell sea correcta:

# Verificar ruta de node
which node

# Debe apuntar al directorio de fnm
# ~/.fnm/node-versions/.../bin/node

El Archivo de Versión No Funciona

# Confirmar que --use-on-cd está habilitado
eval "$(fnm env --use-on-cd)"

# Confirmar que el archivo de versión existe
cat .node-version

Enlaces Relacionados

• Gestión de Versiones - Guía de gestión de versiones
• Referencia de Comandos - Todos los detalles de comandos
• Comando install - Detalles del comando install