Alternar entre versões do Node.js com nvm

Esta página explica como usar o comando nvm use para alternar entre diferentes versões do Node.js instaladas no seu sistema.

O comando nvm use

O comando nvm use modifica a variável de ambiente PATH para utilizar uma versão específica do Node.js. Se você tem várias versões do Node.js instaladas através do nvm, este comando permite que você alterne entre elas.

Sintaxe

nvm use [<version>]

Opções

• <version>: A versão do Node.js que você deseja utilizar. Pode ser um número de versão completo ou parcial, ou um alias.
• --lts: Utilizar a última versão LTS (Suporte de Longo Prazo) disponível.
• --silent: Suprimir mensagens de saída.
• --save: Escrever a versão no arquivo .nvmrc.

Exemplos de uso

Utilizar uma versão específica

nvm use 14.17.0

O resultado será:

Now using node v14.17.0 (npm v6.14.13)

Utilizar uma versão parcial

nvm use 14

Este comando utilizará a última versão 14.x.x instalada no seu sistema.

Utilizar a última versão

nvm use node

Este comando utilizará a última versão do Node.js instalada no seu sistema.

Utilizar a última versão LTS

nvm use --lts

Este comando utilizará a última versão LTS do Node.js instalada no seu sistema.

Uso com .nvmrc

Se você tem um arquivo .nvmrc no diretório do seu projeto, você pode simplesmente executar:

nvm use

Sem especificar uma versão, e o nvm utilizará automaticamente a versão especificada no arquivo .nvmrc.

Exemplo de arquivo .nvmrc

Um arquivo .nvmrc contém simplesmente o número da versão do Node.js que você deseja utilizar para aquele projeto:

14.17.0

Verificar a versão ativa

Para verificar qual versão do Node.js está atualmente ativa, use:

nvm current

ou

node -v

Solução de problemas

Se você encontrar um erro como N/A: version "x.x.x" is not yet installed, isso significa que a versão solicitada não está instalada. Você pode instalá-la com:

nvm install x.x.x

e então tentar novamente nvm use x.x.x.

Notas importantes

• No Windows, você pode precisar executar o nvm em um terminal com privilégios de administrador para algumas operações.
• Se você estiver usando o nvm-windows, os comandos podem diferir ligeiramente daqueles do nvm para Linux/macOS.
• Para utilizar uma versão do Node.js permanentemente, você pode definir um alias padrão com nvm alias default <version>.