Referência de Comandos fnm

fnm fornece um conjunto conciso e poderoso de ferramentas de linha de comando para gerenciar versões do Node.js.

Visão Geral dos Comandos

fnm [OPÇÕES] <COMANDO>

Opções Globais

Opção	Descrição	Padrão
--node-dist-mirror <URL>	Mirror para download do Node.js	https://nodejs.org/dist
--fnm-dir <DIR>	Diretório de instalação do fnm	~/.fnm
--log-level <LEVEL>	Nível de log	info
--arch <ARCH>	Substituição de arquitetura	Arquitetura do sistema
--version-file-strategy <STRATEGY>	Estratégia de análise de arquivo de versão	local
--corepack-enabled	Habilitar Corepack	false
--resolve-engines	Resolver engines.node em package.json	true

Comandos Principais

fnm install

Instalar novas versões do Node.js.

fnm install [OPÇÕES] [VERSÃO]

Parâmetros:

• VERSÃO - Número da versão, pode ser semver parcial ou nome da versão LTS (ex: lts/iron)

Opções:

• --lts - Instalar a versão LTS mais recente
• --latest - Instalar a versão mais recente
• --use - Usar a versão imediatamente após a instalação
• --progress <auto|never|always> - Exibir barra de progresso do download

Exemplos:

# Versão fnm
fnm --version


# Instalar versão LTS mais recente
fnm install --lts

# Instalar versão mais recente
fnm install --latest

# Instalar versão específica
fnm install 20
fnm install 18.17.0

# Instalar versão LTS específica
fnm install lts/iron

# Instalar e usar imediatamente
fnm install 20 --use

fnm use

Alternar versão do Node.js.

fnm use [OPÇÕES] [VERSÃO]

Opções:

• --install-if-missing - Instalar automaticamente se a versão não estiver instalada
• --silent-if-unchanged - Não exibir mensagem se a versão não mudar

Exemplos:

# Usar versão específica
fnm use 20

# Usar versão instalada mais recente
fnm use

# Instalar automaticamente se não estiver instalada
fnm use 18 --install-if-missing

fnm list

Listar versões do Node.js instaladas localmente.

fnm list [OPÇÕES]

Alias: ls

Exemplo:

fnm list

Exemplo de saída:

* v20.10.0 default
  v18.19.0
  v16.20.2

fnm list-remote

Listar todas as versões remotas disponíveis do Node.js.

fnm list-remote [OPÇÕES]

Alias: ls-remote

Opções:

• --filter <FILTER> - Filtrar por número da versão ou intervalo semver
• --lts [<NAME>] - Mostrar apenas versões LTS
• --latest - Mostrar apenas versões mais recentes
• --sort <asc|desc> - Ordem de classificação

Exemplos:

# Listar todas as versões
fnm list-remote

# Listar apenas versões LTS
fnm list-remote --lts

# Listar versão LTS específica
fnm list-remote --lts=iron

# Filtrar versões
fnm list-remote --filter=18

# Mostrar apenas versões mais recentes
fnm list-remote --latest

fnm uninstall

Desinstalar versão do Node.js.

fnm uninstall [OPÇÕES] [VERSÃO]

Alias: uni

Exemplos:

# Desinstalar versão específica
fnm uninstall 16.20.2

# Desinstalar via alias
fnm uninstall default

WARNING

Se um alias for fornecido, o fnm excluirá a versão do Node.js para a qual o alias aponta, bem como outros aliases apontando para a mesma versão.

Comandos de Gerenciamento de Versão

fnm default

Definir ou obter a versão padrão do Node.js.

fnm default [VERSÃO]

Exemplos:

# Definir versão padrão
fnm default 20

# Obter versão padrão atual
fnm default

fnm current

Exibir a versão do Node.js atualmente em uso.

fnm current

Exemplo:

fnm current
# Saída: v20.10.0

fnm alias

Definir um alias para uma versão.

fnm alias <VERSÃO> <NOME>

Exemplos:

# Definir alias
fnm alias 20 default
fnm alias 18 legacy

# Usar alias
fnm use default

fnm unalias

Excluir um alias.

fnm unalias <NOME>

Exemplo:

fnm unalias legacy

Comandos de Configuração de Ambiente

fnm env

Exibir configuração de variáveis de ambiente do Shell.

fnm env [OPÇÕES]

Opções:

• --shell <bash|zsh|fish|powershell> - Especificar tipo de Shell
• --json - Exibir em formato JSON
• --use-on-cd - Exibir script de troca automática de versão

Exemplos:

# Exibir configuração atual do Shell
fnm env

# Exibir configuração do Bash
fnm env --shell bash

# Exibir formato JSON
fnm env --json

# Habilitar troca automática de versão
fnm env --use-on-cd

fnm completions

Exibir script de conclusão do Shell.

fnm completions [OPÇÕES]

Opções:

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

Exemplos:

# 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 Avançados

fnm exec

Executar um comando em um ambiente de versão específica do Node.js.

fnm exec [OPÇÕES] -- <COMANDO>

Opções:

• --using <VERSÃO> - Especificar a versão a ser usada

Exemplos:

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

# Executar script usando versão específica
fnm exec --using=20 -- npm run build

Tabela de Comandos

Comando	Alias	Descrição
install	i	Instalar versão do Node.js
use	-	Alternar versão do Node.js
list	ls	Listar versões instaladas
list-remote	ls-remote	Listar versões remotas
uninstall	uni	Desinstalar versão do Node.js
default	-	Definir/obter versão padrão
current	-	Mostrar versão atual
alias	-	Definir alias de versão
unalias	-	Excluir alias
env	-	Exibir configuração de ambiente
completions	-	Exibir script de conclusão
exec	-	Executar comando na versão especificada

Links Relacionados

• Instalar Node.js - Guia de instalação detalhado
• Gerenciamento de Versão - Melhores práticas de gerenciamento de versão
• Comando install - Explicação detalhada do comando install