Introdução
- Gerenciar múltiplas versões do Node.js pode ser complicado, mas o NVM (Node Version Manager) facilita muito esse processo.
- Com o NVM, é possível instalar, desinstalar e usar diferentes versões do Node.js em diferentes projetos sem complicações.
A versão do NVM no momento de escrita deste post era a v0.39.0. Para garantir uma versão mais recente, copie esse mesmo comando na página do repositório do NVM no GitHub.
Instalação do NVM (MacOS e Linux)
É recomendado desinstalar qualquer versão do Node.js presente em sua máquina antes de instalar o NVM para evitar colisões.
Para instalar o NVM, basta usar o curl
ou wget
. Execute no terminal:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
ou
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Depois execute no terminal:
source ~/.nvm/nvm.sh
Isso vai executar um script que clona o repositório do NVM e coloca em um diretório chamado ~/.nvm/
, que é onde serão instaladas as várias versões do Node.js que você quiser.
Comandos do NVM
Listar Versões Instaladas
- Comando:
nvm ls
- Lista todas as versões do Node.js instaladas na sua máquina.
Listar Versões Disponíveis para Instalação
- Comando:
nvm ls-remote
- Lista todas as versões do Node.js disponíveis para instalação.
Instalar uma Versão
- Comando:
nvm install vX.X.X
- Instala a versão especificada do Node.js (substitua
X.X.X
pela versão desejada).
- Instala a versão especificada do Node.js (substitua
- Para instalar a versão mais recente:
nvm install vX.X.X
Desinstalar uma Versão
- Comando:
nvm uninstall vX.X.X
- Desinstala a versão especificada do Node.js (substitua
X.X.X
pela versão desejada).
- Desinstala a versão especificada do Node.js (substitua
Usar uma Versão do Node.js
- Comando:
nvm use vX.X.X
- Define a versão especificada como a ativa no terminal atual (substitua
X.X.X
pela versão desejada).
- Define a versão especificada como a ativa no terminal atual (substitua
- Para usar a versão mais recente:
nvm use node
Definir um Nome para uma Versão
- Comando:
nvm alias meunome vX.X.X
- Cria um apelido para a versão especificada do Node.js.
- Para usar o apelido:
nvm use meunome
Remover um Nome de Versão
- Comando:
nvm unalias meunome
- Remove o apelido criado para uma versão do Node.js.
Definir uma Versão Padrão
- Comando:
nvm alias default vX.X.X
- Define a versão especificada como padrão.
- Para definir a versão mais recente como padrão:
nvm alias default node
Indicação da Versão Atual
- Comando:
nvm current
- Exibe a versão atual do Node.js em uso.
Migração de Pacotes Globais
- Comando:
nvm install 6 --reinstall-packages-from=5
- Instala a versão 6 do Node.js e migra os pacotes globais da versão 5.
- Para instalar a versão mais recente e migrar pacotes:
nvm install node --reinstall-packages-from=node
Definição de Versão por Projeto
- Arquivo:
.nvmrc
- Crie um arquivo
.nvmrc
na raiz do projeto e insira o número da versão do Node.js que o projeto utiliza (ex:v12.4.0
).
- Crie um arquivo
- Comando:
nvm use
- O NVM usará a versão especificada no arquivo
.nvmrc
do projeto.
- O NVM usará a versão especificada no arquivo