Guia do Comando fnm use

O comando fnm use é usado para alternar a versão do Node.js atualmente em uso.

Sintaxe do Comando

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

Parâmetros

VERSÃO

Especificar a versão do Node.js para alternar:

# Alternar para versão principal
fnm use 20

# Alternar para versão específica
fnm use 20.10.0

# Usar alias
fnm use default

# Nenhuma versão especificada, lê do arquivo de versão
fnm use

Opções

--install-if-missing

Instalar automaticamente a versão se ainda não estiver instalada:

fnm use 18 --install-if-missing

--silent-if-unchanged

Não exibir mensagem se a versão não mudar:

fnm use 20 --silent-if-unchanged

--node-dist-mirror

Usado com --install-if-missing para especificar mirror de download:

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

--fnm-dir

Especificar diretório de instalação do fnm:

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

--log-level

Definir nível de log:

fnm use 20 --log-level=quiet

Exemplos de Uso

Alternância Básica

# Alternar para Node.js 20
fnm use 20

# Alternar para Node.js 18.17.0
fnm use 18.17.0

Instalar e Alternar Automaticamente

# Instalar automaticamente se a versão não estiver instalada
fnm use 16 --install-if-missing

Alternar Usando Alias

# Usar alias predefinido
fnm use default
fnm use legacy

Modo Silencioso

# Usar em scripts para evitar saída desnecessária
fnm use 20 --silent-if-unchanged

Prioridade de Seleção de Versão

Quando nenhuma versão é especificada, o fnm pesquisa na seguinte ordem:

1. Arquivo .node-version
2. Arquivo .nvmrc
3. package.json engines.node
4. Versão padrão

Diferença do Comando default

• fnm use - Alterna a versão para a sessão atual do Shell
• fnm default - Define a versão padrão global

# Definir versão padrão (afeta novos terminais)
fnm default 20

# Alternar versão temporariamente (apenas terminal atual)
fnm use 18

Problemas Comuns

Versão Não Instalada

# Mensagem de erro
error: Can't find version 18.0.0

# Solução: Instalar automaticamente
fnm use 18 --install-if-missing

Versão do node Não Muda Após Alternância

Certifique-se de que a configuração do Shell está correta:

# Verificar caminho do node
which node

# Deve apontar para o diretório fnm
# ~/.fnm/node-versions/.../bin/node

Arquivo de Versão Não Funciona

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

# Confirmar se o arquivo de versão existe
cat .node-version

Links Relacionados

• Gerenciamento de Versão - Guia de gerenciamento de versão
• Referência de Comandos - Todas as informações de comandos
• Comando install - Detalhes do comando install