Instalar Node.js com fnm

fnm torna simples e rápido instalar e gerenciar versões do Node.js. Este guia detalhará como usar fnm para instalar Node.js.

Início Rápido

Instalar Última Versão LTS

fnm install --lts

Instalar Última Versão

fnm install --latest

Instalar Versão Específica

fnm install 20
fnm install 18.17.0

Métodos de Instalação Explicados

Instalar Versão LTS

As versões LTS (Long Term Support) do Node.js são recomendadas para ambientes de produção:

# Instalar última versão LTS
fnm install --lts

# Instalar versão 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

Codinomes de Versão LTS:

Codinome	Versão	Status
Iron	20.x	LTS Ativo
Hydrogen	18.x	Manutenção
Gallium	16.x	Fim de Vida

Instalar Versão Específica

# Instalar versão principal (seleciona automaticamente a versão secundária mais recente)
fnm install 20

# Instalar versão específica
fnm install 20.10.0

# Instalar versão antiga
fnm install 14.21.3

Instalar Usando Arquivo de Versão

Crie um arquivo .node-version ou .nvmrc no diretório do projeto:

# Criar arquivo .node-version
echo "20" > .node-version

# fnm lerá e instalará automaticamente
fnm install

Usar Após Instalação

Alternar para Versão Instalada

# Usar versão específica
fnm use 20

# Se a versão não estiver instalada, instalar automaticamente e usar
fnm use 18 --install-if-missing

Definir Versão Padrão

# Definir versão padrão
fnm default 20

# Visualizar versão padrão atual
fnm default

Usar Imediatamente Após Instalação

# Instalar e alternar para a versão imediatamente
fnm install 20 --use

Visualizar Versões Disponíveis

Visualizar Versões Remotas

# Listar todas as versões disponíveis
fnm list-remote

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

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

# Visualizar versões mais recentes
fnm list-remote --latest

Visualizar Versões Instaladas Localmente

fnm list

Exemplo de saída:

* v20.10.0 default
  v18.19.0
  v16.20.2

Usar Mirror para Download Mais Rápido

Na China continental, você pode usar um mirror para acelerar downloads:

# Definir variável de ambiente do mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Ou especificar durante instalação
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

Mirrors comuns:

Fonte do Mirror	URL
npmmirror	https://npmmirror.com/mirrors/node
Universidade de Tsinghua	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release

Suporte Corepack

fnm suporta Corepack, que pode habilitar automaticamente Yarn e pnpm:

# Habilitar Corepack durante instalação
fnm install 20 --corepack-enabled

# Ou definir variável de ambiente
export FNM_COREPACK_ENABLED=true
fnm install 20

Melhores Práticas de Gerenciamento de Versão

Gerenciamento de Versão em Nível de Projeto

Crie um arquivo .node-version na raiz do projeto:

# Especificar versão principal
echo "20" > .node-version

# Ou especificar versão exata
echo "20.10.0" > .node-version

Combinado com a opção --use-on-cd, alterna versões automaticamente ao entrar no diretório:

# Adicionar à configuração do Shell
eval "$(fnm env --use-on-cd)"

Desenvolvimento Multi-Versão

# Instalar múltiplas versões
fnm install 20
fnm install 18
fnm install 16

# Alternar entre diferentes projetos
cd project-a && fnm use 20
cd project-b && fnm use 18

Usar Aliases

# Definir aliases
fnm alias 20 default
fnm alias 18 legacy

# Alternar usando aliases
fnm use default
fnm use legacy

Problemas Comuns

Instalação Falhou

Se a instalação falhar, verifique:

1. Se a conexão de rede está normal
2. Se precisa configurar um mirror
3. Se há espaço em disco suficiente

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

Troca de Versão Não Funciona

Certifique-se de que o Shell está configurado corretamente:

# Verificar versão atual
fnm current

# Verificar caminho do node
which node

Limpar Versões Antigas

# Visualizar versões instaladas
fnm list

# Desinstalar versões não necessárias
fnm uninstall 16.20.2

Links Relacionados

• Instalar fnm - Instalar fnm
• Referência de Comandos - Todas as informações de comandos
• Gerenciamento de Versão - Guia detalhado de gerenciamento de versão