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.

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 em C:Program Filesnodejs.

Instalando o nvm-windows

1. Baixe a versão mais recente do nvm-windows.

2. Execute o nvm-setup.exe e siga as instruções (use os locais padrão).

3. 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

Posso usar o NVM original no Windows?

Não, o NVM original é para Linux e macOS. Usuários do Windows devem usar o nvm-windows.

Por que o `nvm use` não atualiza minha versão do Node.js?

Geralmente, isso é causado por instalações residuais do Node. Remova ou renomeie quaisquer pastas de instalação do Node existentes.

Preciso de direitos de administrador para usar o NVM?

Sim, a menos que você ative o Modo de Desenvolvedor no Windows.

Como desinstalo uma versão do Node do NVM?

Use o comando `nvm uninstall <versão>`.

Onde as versões do Node.js são instaladas?

Tipicamente em `%AppData%Roamingnvm`. Cada versão é instalada separadamente.