Perguntas frequentes sobre o NVM para Windows

Problemas de instalação

Por que recebo o erro "nvm não é reconhecido como um comando interno ou externo"?

Este erro ocorre quando o Windows não consegue encontrar o comando nvm no caminho do sistema. Para resolver:

1. Reinicie seu computador após a instalação
2. Se o problema persistir, verifique se o caminho de instalação do NVM está na sua variável de ambiente PATH:
   • Abra Painel de Controle > Sistema > Configurações avançadas do sistema > Variáveis de ambiente
   • Verifique se o caminho para o NVM (por exemplo, C:\Users\<username>\AppData\Roaming\nvm) está na variável PATH do usuário

Devo desinstalar o Node.js antes de instalar o NVM?

Sim, é recomendável desinstalar qualquer versão existente do Node.js antes de instalar o NVM para Windows. Isso evita possíveis conflitos entre a instalação global do Node.js e as versões gerenciadas pelo NVM.

Como posso reinstalar o NVM sem perder minhas versões do Node.js?

Se você precisar reinstalar o NVM, mas quiser manter suas versões do Node.js:

1. Faça um backup do diretório C:\Users\<username>\AppData\Roaming\nvm
2. Desinstale o NVM
3. Instale a nova versão do NVM
4. Restaure o conteúdo do diretório de backup

Problemas com o Node.js

Por que não consigo instalar uma versão específica do Node.js?

Se você estiver tendo problemas para instalar uma versão específica:

1. Certifique-se de ter uma conexão de internet estável
2. Execute a linha de comando como administrador
3. Desative temporariamente seu antivírus ou firewall
4. Tente usar um espelho alternativo:

   nvm node_mirror https://npmmirror.com/mirrors/node/

Como posso usar uma versão específica do Node.js para um projeto?

Existem duas maneiras de especificar uma versão do Node.js para um projeto:

1. Criar um arquivo .nvmrc na raiz do projeto com o número da versão (por exemplo, 18.16.0)
2. Mudar manualmente para a versão desejada ao trabalhar no projeto:

   nvm use 18.16.0

Por que recebo erros de permissão ao instalar pacotes globais?

Se você receber erros de permissão ao instalar pacotes npm globais:

1. Certifique-se de estar executando a linha de comando com permissões de administrador
2. Verifique se está usando a versão correta do Node.js:

   nvm current

Problemas de configuração

Como posso configurar uma versão padrão do Node.js?

Para configurar uma versão padrão que será usada sempre que você abrir uma nova janela de terminal:

nvm alias default 18.16.0

Como posso acelerar os downloads do Node.js?

Se os downloads estiverem lentos, você pode configurar o NVM para usar um espelho mais próximo da sua localização:

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

Consulte o guia de espelhos para mais opções.

Onde as configurações do NVM são armazenadas?

As configurações do NVM para Windows são armazenadas em:

• Configuração do NVM: C:\Users\<username>\AppData\Roaming\nvm\settings.txt
• Versões instaladas do Node.js: C:\Users\<username>\AppData\Roaming\nvm\<version>

Problemas específicos do Windows

O NVM funciona no PowerShell?

Sim, o NVM para Windows funciona tanto no Prompt de Comando (cmd) quanto no PowerShell. No entanto, se você estiver tendo problemas com o PowerShell, certifique-se de que a execução de scripts esteja habilitada:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Como posso usar o NVM com o Visual Studio Code?

Para usar o NVM com o Visual Studio Code:

1. Configure uma versão padrão do Node.js com nvm alias default <version>
2. Reinicie o VS Code para que ele detecte a versão do Node.js
3. Alternativamente, você pode especificar o caminho completo para a versão do Node.js nas configurações do VS Code

Como posso usar o NVM com o WSL (Windows Subsystem for Linux)?

O NVM para Windows não funciona diretamente no WSL, pois o WSL usa um ambiente Linux. Para o WSL, você deve instalar a versão Linux do NVM (nvm-sh/nvm). Consulte o guia de instalação do nvm-sh para instruções.

Solução de problemas avançada

Como posso depurar problemas com o NVM?

Para obter mais informações sobre o que o NVM está fazendo, você pode habilitar o registro:

1. Crie ou edite o arquivo settings.txt no diretório de instalação do NVM
2. Adicione a linha: root: <caminho de instalação do NVM>
3. Adicione a linha: log: <caminho onde você deseja salvar os logs>

Como posso contribuir ou relatar bugs?

Se você encontrar um bug ou quiser contribuir para o projeto:

1. Relate problemas no repositório GitHub do nvm-windows
2. Certifique-se de incluir detalhes sobre seu sistema operacional, versão do NVM e etapas para reproduzir o problema

Perguntas gerais

Qual é a diferença entre o NVM para Windows e o nvm-sh?

O NVM para Windows (nvm-windows) é uma reimplementação do NVM especificamente para Windows, enquanto o nvm-sh/nvm é a implementação original para sistemas Unix/Linux. Embora compartilhem um propósito semelhante, eles têm bases de código diferentes e algumas diferenças em comandos e recursos.

Posso usar o NVM para Windows em sistemas operacionais de 32 bits?

Sim, o NVM para Windows é compatível com sistemas operacionais Windows de 32 e 64 bits. Você pode alternar entre arquiteturas usando o comando nvm arch.

O NVM instala automaticamente o npm?

Sim, quando você instala uma versão do Node.js usando o NVM, o npm é instalado automaticamente como parte do pacote Node.js.