Back

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

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

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.

Listen to your bugs 🧘, with OpenReplay

See how users use your app and resolve issues fast.
Loved by thousands of developers