Skip to content

Referencia de Comandos de fnm

fnm proporciona un conjunto conciso y potente de herramientas de línea de comandos para gestionar versiones de Node.js.

Resumen de Comandos

fnm [OPCIONES] <COMANDO>

Opciones Globales

OpciónDescripciónPredeterminado
--node-dist-mirror <URL>Mirror de descarga de Node.jshttps://nodejs.org/dist
--fnm-dir <DIR>Directorio de instalación de fnm~/.fnm
--log-level <LEVEL>Nivel de registroinfo
--arch <ARCH>Anular arquitecturaArquitectura del sistema
--version-file-strategy <STRATEGY>Estrategia de análisis de archivo de versiónlocal
--corepack-enabledHabilitar Corepackfalse
--resolve-enginesResolver engines.node en package.jsontrue

Comandos Principales

fnm install

Instalar nuevas versiones de Node.js.

bash
fnm install [OPCIONES] [VERSION]

Parámetros:

  • VERSION - Número de versión, puede ser semver parcial o nombre de versión LTS (ej. lts/iron)

Opciones:

  • --lts - Instalar la última versión LTS
  • --latest - Instalar la última versión
  • --use - Usar la versión inmediatamente después de la instalación
  • --progress <auto|never|always> - Mostrar barra de progreso de descarga

Ejemplos:

bash
# Versión de fnm
fnm --version


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

# Instalar la última versión
fnm install --latest

# Instalar versión específica
fnm install 20
fnm install 18.17.0

# Instalar versión LTS específica
fnm install lts/iron

# Instalar y usar inmediatamente
fnm install 20 --use

fnm use

Cambiar la versión de Node.js.

bash
fnm use [OPCIONES] [VERSION]

Opciones:

  • --install-if-missing - Instalar automáticamente si la versión no está instalada
  • --silent-if-unchanged - No mostrar mensaje si la versión no cambia

Ejemplos:

bash
# Usar versión específica
fnm use 20

# Usar la última versión instalada
fnm use

# Auto instalar si no está instalada
fnm use 18 --install-if-missing

fnm list

Listar versiones de Node.js instaladas localmente.

bash
fnm list [OPCIONES]

Alias: ls

Ejemplo:

bash
fnm list

Ejemplo de salida:

* v20.10.0 default
  v18.19.0
  v16.20.2

fnm list-remote

Listar todas las versiones remotas disponibles de Node.js.

bash
fnm list-remote [OPCIONES]

Alias: ls-remote

Opciones:

  • --filter <FILTER> - Filtrar por número de versión o rango semver
  • --lts [<NAME>] - Mostrar solo versiones LTS
  • --latest - Mostrar solo últimas versiones
  • --sort <asc|desc> - Orden de clasificación

Ejemplos:

bash
# Listar todas las versiones
fnm list-remote

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

# Listar versión LTS específica
fnm list-remote --lts=iron

# Filtrar versiones
fnm list-remote --filter=18

# Mostrar solo últimas versiones
fnm list-remote --latest

fnm uninstall

Desinstalar versión de Node.js.

bash
fnm uninstall [OPCIONES] [VERSION]

Alias: uni

Ejemplos:

bash
# Desinstalar versión específica
fnm uninstall 16.20.2

# Desinstalar mediante alias
fnm uninstall default

WARNING

Si se proporciona un alias, fnm eliminará la versión de Node.js a la que apunta ese alias, así como otros alias que apunten a la misma versión.

Comandos de Gestión de Versiones

fnm default

Establecer u obtener la versión predeterminada de Node.js.

bash
fnm default [VERSION]

Ejemplos:

bash
# Establecer versión predeterminada
fnm default 20

# Obtener versión predeterminada actual
fnm default

fnm current

Mostrar la versión de Node.js actualmente utilizada.

bash
fnm current

Ejemplo:

bash
fnm current
# Salida: v20.10.0

fnm alias

Establecer un alias para una versión.

bash
fnm alias <VERSION> <NAME>

Ejemplos:

bash
# Establecer alias
fnm alias 20 default
fnm alias 18 legacy

# Usar alias
fnm use default

fnm unalias

Eliminar un alias.

bash
fnm unalias <NAME>

Ejemplo:

bash
fnm unalias legacy

Comandos de Configuración de Entorno

fnm env

Mostrar configuración de variables de entorno del Shell.

bash
fnm env [OPCIONES]

Opciones:

  • --shell <bash|zsh|fish|powershell> - Especificar tipo de Shell
  • --json - Mostrar en formato JSON
  • --use-on-cd - Mostrar script de cambio automático de versión

Ejemplos:

bash
# Mostrar configuración actual del Shell
fnm env

# Mostrar configuración de Bash
fnm env --shell bash

# Mostrar formato JSON
fnm env --json

# Habilitar cambio automático de versión
fnm env --use-on-cd

fnm completions

Mostrar script de autocompletado del Shell.

bash
fnm completions [OPCIONES]

Opciones:

  • --shell <bash|zsh|fish|powershell> - Especificar tipo de Shell

Ejemplos:

bash
# Bash
fnm completions --shell bash >> ~/.bashrc

# Zsh
fnm completions --shell zsh >> ~/.zshrc

# Fish
fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

# PowerShell
fnm completions --shell powershell >> $PROFILE

Comandos Avanzados

fnm exec

Ejecutar un comando en un entorno de versión específica de Node.js.

bash
fnm exec [OPCIONES] -- <COMMAND>

Opciones:

  • --using <VERSION> - Especificar la versión a usar

Ejemplos:

bash
# Ejecutar comando usando Node.js 18
fnm exec --using=18 -- node --version

# Ejecutar script usando versión específica
fnm exec --using=20 -- npm run build

Hoja de Trucos de Comandos

ComandoAliasDescripción
installiInstalar versión de Node.js
use-Cambiar versión de Node.js
listlsListar versiones instaladas
list-remotels-remoteListar versiones remotas
uninstalluniDesinstalar versión de Node.js
default-Establecer/obtener versión predeterminada
current-Mostrar versión actual
alias-Establecer alias de versión
unalias-Eliminar alias
env-Mostrar configuración de entorno
completions-Mostrar script de autocompletado
exec-Ejecutar comando en versión especificada

Enlaces Relacionados