Instalar npm com fnm

npm (Node Package Manager) é instalado junto com o Node.js. Este guia apresenta como gerenciar npm através do fnm.

Relação entre npm e fnm

Quando você instala Node.js usando fnm, o npm é automaticamente incluído:

# Instalar Node.js (automaticamente inclui npm)
fnm install 20

# Verificar versão npm
npm --version

Verificar Versão npm

# Visualizar versão npm atual
npm --version

# Visualizar versões Node.js e npm
node --version
npm --version

Diferentes versões do Node.js correspondem a diferentes versões do npm:

Node.js	npm
20.x	10.x
18.x	9.x
16.x	8.x

Atualizar npm

Usando Auto-Atualização do npm

# Atualizar para versão mais recente
npm install -g npm@latest

# Atualizar para versão específica
npm install -g npm@10.2.0

Alternar Versão do Node.js

Alternar versão do Node.js também alterna a versão do npm:

# Alternar para Node.js 20
fnm use 20
npm --version  # Saída: 10.x.x

# Alternar para Node.js 18
fnm use 18
npm --version  # Saída: 9.x.x

Gerenciamento de Pacotes Globais npm

Visualizar Caminho de Instalação Global

npm config get prefix

Localização de Pacotes Globais

Pacotes globais do Node.js gerenciados pelo fnm estão localizados em:

~/.fnm/node-versions/<version>/installation/lib/node_modules

Instalar Pacotes Globais

# Instalar pacotes globais
npm install -g pnpm
npm install -g yarn
npm install -g typescript

# Visualizar pacotes globais
npm list -g --depth=0

Usar Corepack

Corepack é um gerenciador de gerenciadores de pacotes para Node.js que pode gerenciar npm, yarn e pnpm:

Habilitar Corepack

# Habilitar Corepack ao instalar Node.js
fnm install 20 --corepack-enabled

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

Usar Corepack

# Habilitar Corepack
corepack enable

# Usar versão específica do yarn
corepack prepare yarn@stable --activate

# Usar versão específica do pnpm
corepack prepare pnpm@latest --activate

Configuração npm

Configurar Mirror

# Definir mirror npm
npm config set registry https://registry.npmmirror.com

# Visualizar configuração atual
npm config list

# Restaurar mirror padrão
npm config set registry https://registry.npmjs.org

Mirrors Comuns

Fonte do Mirror	URL
npm Oficial	https://registry.npmjs.org
npmmirror	https://registry.npmmirror.com
Tencent Cloud	https://mirrors.cloud.tencent.com/npm/

Gerenciamento de Múltiplas Versões npm

Como o npm é instalado com o Node.js, a melhor maneira de gerenciar múltiplas versões do npm é:

Método 1: Alternar Versão do Node.js

# Instalar múltiplas versões do Node.js
fnm install 20
fnm install 18

# Alternar versões
fnm use 20  # npm 10.x
fnm use 18  # npm 9.x

Método 2: Atualizar npm Independentemente

# Atualizar npm na versão atual do Node.js
npm install -g npm@latest

Problemas Comuns

Comando npm Não Encontrado

# Confirmar se Node.js está instalado
fnm list

# Confirmar versão atual em uso
fnm current

# Reinstalar Node.js
fnm install 20 --use

Instalação de Pacote Global Falhou

# Limpar cache npm
npm cache clean --force

# Verificar permissões
ls -la ~/.fnm/node-versions/

# Reinstalar
npm install -g <package>

Versão npm Incompatível

# Verificar versão Node.js
fnm current

# Restaurar versão padrão do npm
fnm uninstall <version>
fnm install <version>

Melhores Práticas

1. Usar Campo engines no package.json

Especificar versões do Node.js e npm no projeto:

{
  "engines": {
    "node": ">=18.0.0",
    "npm": ">=9.0.0"
  }
}

2. Usar Arquivo .npmrc

Criar arquivo .npmrc no projeto:

registry=https://registry.npmmirror.com
save-exact=true

3. Bloquear Gerenciador de Pacotes

Usar campo packageManager:

{
  "packageManager": "npm@10.2.0"
}

Links Relacionados

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