Como corrigir o comando npm não encontrado após a instalação do Node.js

O erronpm: comando não encontrado (ou‘npm’ não é reconhecido como um comando interno ou externono Windows) significa que seu shell não consegue localizar o npm mesmo que você tenha instalado o Node.js. Quase sempre é um problema de PATH. Veja como consertar isso em todas as plataformas.

Por que isso acontece

npm vem com Node.js. Senpm não foi encontrado, o Node.js não foi instalado corretamente ou o diretório que contémnpm não está no PATH do seu sistema – a lista de locais em que seu shell procura comandos.

Etapa 1: Verifique se o Node.js está realmente instalado

# Check if node exists
node --version
# v20.11.0  → Node is installed, npm PATH issue
# command not found → Node itself isn't installed/in PATH

# Check npm
npm --version
which npm    # macOS/Linux — shows npm location
where npm    # Windows

Correção 1: reinstale o Node.js (mais simples)

Se nenhumnode nemnpm for encontrado, reinstale o Node.js corretamente:

# Download the LTS installer from nodejs.org and run it
# The official installer adds Node and npm to PATH automatically

# Verify after install (open a NEW terminal window)
node --version
npm --version

Importante: Sempre abra umnova janela do terminal após a instalação — as alterações de PATH não se aplicam a terminais já abertos.

Correção 2: use nvm (recomendado para desenvolvedores)

O Node Version Manager lida com a instalação do Node e o PATH corretamente e permite alternar versões facilmente:

# macOS/Linux — install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Restart your terminal, then:
nvm install --lts      # install latest LTS Node
nvm use --lts          # use it
node --version         # verify
npm --version          # npm comes with it

# Windows — use nvm-windows instead
# Download from github.com/coreybutler/nvm-windows

Correção 3: adicionar nó ao PATH manualmente (macOS/Linux)

# Find where node is installed
which node
# /usr/local/bin/node  or  /opt/homebrew/bin/node

# Add its directory to PATH in your shell config
# For zsh (~/.zshrc):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# For bash (~/.bashrc or ~/.bash_profile):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Correção 4: correção de PATH no Windows

# 1. Find Node's install location (usually):
#    C:\Program Files
odejs
# 2. Add to PATH:
#    - Search "Environment Variables" in Start menu
#    - Click "Environment Variables"
#    - Under "System variables", select "Path", click "Edit"
#    - Click "New", add: C:\Program Files
odejs#    - Click OK on all dialogs

# 3. Open a NEW Command Prompt/PowerShell and verify:
node --version
npm --version

Correção 5: Homebrew Node no macOS

# If you installed via Homebrew but it's not found
brew install node

# On Apple Silicon Macs, Homebrew is in /opt/homebrew
# Ensure it's in PATH:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Relink if needed
brew link --overwrite node

Causa comum: permissões ou problemas de diretório global

# If npm works but global installs fail with permission errors,
# configure a user-level global directory (avoids sudo):
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Perguntas Frequentes

P: Instalei o Node, mas o npm ainda não foi encontrado. Por que?
R: Geralmente, você precisa abrir uma NOVA janela de terminal — as alterações de PATH não afetam os terminais já abertos. Se isso não funcionar, o diretório do Node não está no seu PATH ou a instalação foi incompleta. Reinstale ou use nvm.

P: Devo usar o nvm ou o instalador direto?
R: O nvm é recomendado para desenvolvedores — ele gerencia o PATH corretamente, evita problemas de permissão e permite alternar versões do Node por projeto. O instalador direto é adequado para configurações simples de versão única.

P: o nó funciona, mas o npm não. Como isso é possível?
R: Raro, mas pode acontecer se o link simbólico do npm for quebrado ou removido. Reinstale o Node.js ou executenpm install -g npm se o nó funcionar. Com nvm, reinstale a versão do Node.

P: Por que recebo erros de permissão com npm install -g?
R: Você está instalando em um diretório do sistema que precisa de direitos de administrador. Nunca usesudo npm – em vez disso, configure um diretório de prefixo em nível de usuário (mostrado acima) ou use nvm, o que evita totalmente o problema.

P: Como posso saber qual arquivo PATH editar — .zshrc, .bashrc ou .bash_profile?
R: Verifique seu shell comecho $SHELL. Se for zsh (padrão no macOS moderno), edite~/.zshrc. Se for bash, edite~/.bashrc (Linux) ou~/.bash_profile (macOS).

Conclusão

“npm: comando não encontrado” é um problema de PATH: seu shell não consegue encontrar a localização do npm. A solução mais rápida e confiável éinstalando Node.js via nvm, que lida com PATH e permissões corretamente e permite alternar versões. Caso contrário, reinstale o Node a partir do instalador oficial e sempre abra umnova janela do terminal depois. Se o Node estiver instalado, mas não no PATH, adicione seu diretório (encontrado viawhich node) ao seu arquivo de configuração do shell. Noventa por cento dos casos são resolvidos usando nvm ou abrindo um novo terminal.