Perguntas frequentes sobre nvm-sh (FAQ)

Versão Linux/macOS

Adicione ao ~/.bashrc ou ~/.zshrc:

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node

Instalei o NVM, mas o comando nvm não funciona

Isso pode ser causado por várias razões:

1. Variáveis de ambiente não configuradas corretamente: Certifique-se de que o diretório NVM foi adicionado ao seu PATH
2. Necessidade de reiniciar o terminal: Após a instalação, feche e reabra seu terminal ou prompt de comando
3. Arquivo de configuração não atualizado: Verifique se seu arquivo de configuração bash (.bashrc, .bash_profile, .zshrc, etc.) inclui o código de inicialização do NVM

Problemas de uso

A versão do Node.js volta para a padrão toda vez que abro um novo terminal

Isso acontece porque o NVM carrega a versão padrão em cada nova sessão do terminal. Para resolver esse problema, você pode:

1. Definir uma versão padrão do Node.js:

   nvm alias default 14.17.0

2. Criar um arquivo .nvmrc no diretório do seu projeto e executar nvm use no diretório do projeto

Pacotes instalados globalmente desaparecem após mudar de versão do Node.js

Este é um comportamento normal do NVM. Cada versão do Node.js tem seu próprio conjunto separado de pacotes globais. Quando você muda de versão, só pode acessar os pacotes globais instalados para a versão atual.

As soluções incluem:

1. Instalar pacotes globais separadamente em cada versão do Node.js que você precisa
2. Usar o comando nvm reinstall-packages para copiar pacotes de uma versão para outra

Erros SSL ao usar nvm install

Se você encontrar problemas com certificados SSL, pode tentar os seguintes métodos:

# Windows
nvm install 14.17.0 --insecure

# Linux/macOS
NVM_NODEJS_ORG_MIRROR=http://nodejs.org/dist nvm install 14.17.0

Erro ao instalar a versão do Node.js no macOS

Você está encontrando um erro de compilação de módulo do Node.js, que geralmente ocorre ao executar npm install ou yarn install. Mensagem de erro específica:

# Erro:
/,nym/,cache/src/node-y14.18.0/files/out/Release/obj.target/v8 zlib/deps/v8/third party/zlib/zutil.o] Error 1
make[1]: *** [/Users/.../zutil.o] Error 1

Isso indica uma falha na compilação da biblioteca zlib para o motor V8 JavaScript do qual os módulos Node.js dependem.

Solução:

# Instalar Xcode Command Line Tools
xcode-select --install

# Instalar Homebrew (se não estiver instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar Python (Python 3 recomendado)
brew install python

Como desinstalar o NVM?

Linux/macOS

1. Exclua o diretório NVM: rm -rf "$NVM_DIR"
2. Remova as linhas relacionadas ao NVM dos seus arquivos de configuração do shell (.bashrc, .bash_profile, .zshrc, etc.), consulte o Guia de Instalação para detalhes