Guia do Comando fnm install

O comando fnm install é usado para instalar novas versões do Node.js.

Sintaxe do Comando

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

Parâmetros

VERSÃO

Especificar a versão do Node.js a ser instalada:

# 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 LTS
fnm install lts/iron

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

Opções

--lts

Instalar a versão LTS (Long Term Support) mais recente:

fnm install --lts

--latest

Instalar a versão mais recente (incluindo não-LTS):

fnm install --latest

--use

Alternar para a versão imediatamente após a instalação:

fnm install 20 --use

--progress

Controlar exibição da barra de progresso do download:

# Exibição automática (padrão)
fnm install 20 --progress=auto

# Sempre exibir
fnm install 20 --progress=always

# Nunca exibir
fnm install 20 --progress=never

--node-dist-mirror

Especificar mirror para download do Node.js:

fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

--arch

Especificar a arquitetura de instalação:

# Instalar versão x64
fnm install 20 --arch=x64

# Instalar versão ARM64
fnm install 20 --arch=arm64

--fnm-dir

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

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

--log-level

Definir nível de log:

fnm install 20 --log-level=quiet
fnm install 20 --log-level=error
fnm install 20 --log-level=info

--corepack-enabled

Habilitar suporte ao Corepack:

fnm install 20 --corepack-enabled

Exemplos de Uso

Instalar Versão LTS

# Instalar LTS mais recente
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

Instalar Versão Específica

# Instalar versão principal
fnm install 20

# Instalar versão secundária
fnm install 20.10

# Instalar versão exata
fnm install 20.10.0

Instalar e Usar

# Instalar e alternar imediatamente
fnm install 20 --use

# Instalar e definir como padrão
fnm install 20 --use && fnm default 20

Usar Mirror para Download Mais Rápido

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

Instalar Arquitetura Específica

# Instalar versão x64 em Mac Apple Silicon
fnm install 20 --arch=x64

Formatos de Versão

fnm suporta múltiplos formatos de versão:

Formato	Exemplo	Descrição
Versão principal	20	Último 20.x.x
Versão secundária	20.10	Último 20.10.x
Versão exata	20.10.0	Versão exata
Nome LTS	lts/iron	Codinome da versão LTS
latest	--latest	Versão mais recente

Codinomes de Versão LTS

Codinome	Versão	Data de Lançamento
Iron	20.x	2023-10
Hydrogen	18.x	2022-10
Gallium	16.x	2021-10
Erbium	14.x	2020-10
Dubnium	12.x	2019-10

Variáveis de Ambiente

Você pode configurar o comportamento padrão através de variáveis de ambiente:

# Definir mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# Habilitar Corepack
export FNM_COREPACK_ENABLED=true

# Definir diretório de instalação
export FNM_DIR=~/.fnm

Problemas Comuns

Instalação Falhou

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

# Ver logs detalhados
fnm install 20 --log-level=info

Versão Já Existe

# Ver versões instaladas
fnm list

# Usar versão instalada
fnm use 20

Download Lento

# Configurar mirror
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install 20

Links Relacionados

• Instalar Node.js - Guia de instalação
• Referência de Comandos - Todas as informações de comandos
• Gerenciamento de Download - Configuração de download