Veja como corrigir o erro de npm não reconhecido no Windows: teste node e npm, revise o PATH, reinstale o Node.js e reabra o terminal.
Em resumo:
Quando o terminal responde “npm install não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes”, a causa não é o comando em si, mas a forma como o sistema procura por ele.
Na prática, essa mensagem indica que o shell não encontrou o executável do npm em nenhuma das pastas listadas no PATH. Isso costuma acontecer quando o Node.js não foi instalado corretamente, quando a instalação não atualizou o PATH, ou quando o terminal aberto no momento ainda não detectou uma alteração recente feita nessa variável.
Para solucionar esse problema, veja como testar os comandos básicos, confirmar a instalação do Node.js, revisar o PATH e reiniciar o terminal.
Antes de alterar qualquer configuração, vale confirmar o que exatamente está faltando. Abra um terminal novo e digite `node -v`. Se aparecer um número de versão, o Node.js está instalado e acessível nesse shell.
Em seguida, digite `npm -v`. Como o npm é instalado junto com o Node.js, o resultado esperado é também um número de versão.
O comando `node` costuma funcionar, mas `npm` não é reconhecido no mesmo terminal, ou o oposto acontece em outro shell da mesma máquina.
Esse tipo ocorrência sugere que o problema pode estar concentrado em uma parte específica da instalação ou da configuração do PATH, e não necessariamente em todo o ambiente Node.js.
O npm não é um programa separado que se instala isoladamente: ele acompanha a instalação padrão do Node.js.
Quando o diagnóstico indica que nenhum dos dois comandos funciona, o caminho mais direto costuma ser reinstalar o Node.js usando o instalador oficial mais recente para o sistema operacional em uso.
Esse ponto depende da forma exata como cada versão do instalador configura o ambiente, então vale tratar a reinstalação como o primeiro passo prático e confirmar o resultado com os testes de `node -v` e `npm -v` descritos antes de avançar.
Depois de baixar e executar o instalador, é recomendável:
O PATH é a lista de pastas que o sistema consulta, em ordem, sempre que um comando é digitado sem caminho completo.
Se a pasta onde o npm foi instalado não estiver nessa lista, o terminal não encontra o executável, mesmo que ele exista no disco.
No Windows, essa variável pode ser conferida nas configurações de “Variáveis de Ambiente” do sistema, verificando se o caminho da instalação do Node.js (geralmente dentro da pasta de arquivos de programas) aparece listado tanto na seção de variáveis do usuário quanto na do sistema.
Editar a variável de ambiente, ou reinstalar o Node.js, não tem efeito imediato em um terminal que já estava em uso antes da mudança.
Depois de qualquer ajuste no PATH ou de uma nova instalação, é necessário fechar completamente o terminal (e não apenas abrir uma nova aba) e abri-lo de novo.
O mesmo vale para editores de código com terminal integrado: fechar e reabrir o programa garante que a sessão de terminal interna também recarregue as variáveis atualizadas.
Não é possível instalar o npm de forma isolada nesse cenário: ele é distribuído junto com o Node.js. Instalar ou reinstalar o Node.js já traz o npm correspondente àquela versão.
Se `node -v` funciona mas `npm -v` não (ou o contrário), ou se o mesmo comando funciona em um terminal e falha em outro na mesma máquina, o PATH é o primeiro lugar a conferir, verificando se a pasta de instalação do Node.js está listada nas variáveis de ambiente.
Cada terminal carrega o valor do PATH no momento em que é aberto. Um terminal aberto antes de uma alteração no PATH, ou configurado de forma diferente de outro instalado no mesmo computador, pode não refletir a mudança até ser reiniciado.
Na maioria dos relatos analisados, sim, principalmente quando nenhum dos comandos (`node` ou `npm`) funciona em nenhum terminal. Depois de reinstalar, é importante fechar e reabrir o terminal antes de testar novamente.
É a forma como o Windows PowerShell descreve o mesmo problema: o sistema não encontrou nenhum programa, função ou script com aquele nome no PATH configurado para aquela sessão.
O princípio é o mesmo: o shell não encontra o executável nas pastas configuradas para busca de comandos. A forma exata da mensagem e o arquivo de configuração onde o caminho é definido variam entre sistemas, mas o diagnóstico de verificar instalação e variável de ambiente segue a mesma lógica.
Se você quer ingressar ou crescer no mercado da tecnologia, a Allevo Tech oferece formações práticas em áreas de alta demanda, como Engenharia de Software, Ciência de Dados e Inteligência Artificial.
As trilhas são estruturadas para desenvolver competências técnicas e preparar você para os desafios do mercado de trabalho.
Clique no botão abaixo e conheça as formações da Allevo Tech que podem impulsionar a sua trajetória profissional.
Em resumo Esperar horas na fila para abrir a conta em um banco ou passar semanas preenchendo uma papelada só para assinar um serviço é coisa do passado. Graças às tecnologias de integração remota, hoje, as empresas podem conquistar clientes logo no primeiro contato. A transformação passa pelo digital onboarding e ajuda a compreender como […]
Em resumo: A tecnologia deixou de ser apenas um suporte operacional para se tornar o coração das empresas modernas. Negócios que não inovam perdem relevância e espaço em um mercado cada vez mais competitivo. Diante dessa necessidade de evolução constante, a figura de um líder técnico visionário tornou-se indispensável. Alguém precisa olhar para o futuro […]
Em resumo: O mundo corporativo percebeu rapidamente que os dados são o recurso mais valioso do século atual. Empresas que não sabem interpretar suas informações ficam para trás na corrida pela atenção do cliente. E é justamente para organizar essa montanha de informações e traduzi-las em em estratégia prática que o Chief Data Officer (CDO) […]
