Como Alternar Versões do Node.js no Windows usando NVM (Guia Passo a Passo)

Gerenciar diferentes versões do Node.js no Windows pode ser complicado, especialmente quando cada projeto exige sua própria versão. O NVM for Windows resolve esse problema permitindo a alternância fácil entre versões. Este guia explica claramente como instalar e usar o NVM, destacando problemas comuns de instalação e etapas de solução de problemas.
Principais Pontos
- Use o nvm-windows para alternar rapidamente entre versões do Node.js.
- Remova instalações anteriores do Node para evitar conflitos.
- Execute comandos em um terminal de administrador para evitar problemas comuns de permissão.
Instalando o NVM para Windows
Passo 1: Remover Instalações Existentes do Node
Antes de instalar o NVM, desinstale qualquer Node.js existente para evitar conflitos:
- Vá para Configurações > Aplicativos e desinstale o Node.js.
- Certifique-se de que nenhuma pasta
nodejs
permaneça emC:Program Filesnodejs
.
Instalando o nvm-windows
-
Baixe a versão mais recente do nvm-windows.
-
Execute o
nvm-setup.exe
e siga as instruções (use os locais padrão). -
Abra um novo terminal como Administrador e verifique a instalação:
nvm --version
Instalando as Versões Mais Recentes do Node.js
Com o NVM instalado, você pode agora gerenciar facilmente múltiplas versões do Node.js:
- Para instalar a versão LTS mais recente (atualmente Node.js 22.x):
nvm install lts
- Para uma versão específica (por exemplo, Node.js 23.x):
nvm install 23.3.0
Listar versões do Node instaladas:
nvm ls
Como Alternar Versões do Node.js
Uma vez que as versões estão instaladas, alternar é simples:
- Para ativar uma versão específica:
nvm use 22.14.0
- Confirmar a versão ativa:
node -v
npm -v
Solucionando Problemas Comuns do NVM
Problema: O NVM não alterna as versões do Node
Causa: Existe uma instalação anterior do Node.
Solução:
- Exclua ou renomeie a pasta
C:Program Filesnodejs
existente. - Execute
nvm use <versão>
novamente.
Problema: Erros de permissão (acesso negado)
Causa: A criação de links simbólicos precisa de privilégios elevados.
Solução:
- Execute o Prompt de Comando como Administrador, ou
- Ative o Modo de Desenvolvedor do Windows (Configurações > Atualização e Segurança > Para desenvolvedores).
Problema: Comando ‘nvm’ não encontrado
Causa: Variável de ambiente Path não atualizada.
Solução: Feche e reabra seu terminal ou reinicie o Windows.
Problema: Pacotes npm globais ausentes após a alternância
Causa: Pacotes globais são específicos da versão.
Solução: Reinstale pacotes globais para cada versão do Node.js ou use instalações locais (npx
).
Melhores Práticas
- Documente a versão do Node por projeto.
- Atualize regularmente o nvm-windows e remova versões não utilizadas do Node.
- Use versões LTS do Node para estabilidade.
Conclusão
Usar o nvm-windows simplifica o gerenciamento de múltiplas versões do Node.js no Windows. A configuração adequada e a solução de problemas ajudam a evitar armadilhas comuns, facilitando seu processo de desenvolvimento.
Perguntas Frequentes
Não, o NVM original é para Linux e macOS. Usuários do Windows devem usar o nvm-windows.
Geralmente, isso é causado por instalações residuais do Node. Remova ou renomeie quaisquer pastas de instalação do Node existentes.
Sim, a menos que você ative o Modo de Desenvolvedor no Windows.
Use o comando `nvm uninstall <versão>`.
Tipicamente em `%AppData%Roamingnvm`. Cada versão é instalada separadamente.