nvm-sh/nvm

O que é?

Recursos principais

• 01Instalar, alternar e desinstalar várias versões do Node.js por usuário
• 02Referenciar versões LTS com aliases como lts/* em comandos e no .nvmrc
• 03Fixar a versão do Node de um projeto com um arquivo .nvmrc
• 04Executar um comando em uma versão específica do Node sem alterar a versão ativa
• 05Migrar pacotes npm globais durante a instalação ou entre versões instaladas
• 06Usar um espelho personalizado para baixar binários do Node

Casos de uso

• Trabalhar em vários projetos que exigem versões diferentes do Node.js
• Fixar a versão do Node da equipe com um arquivo .nvmrc no repositório
• Configurar o Node.js em contêineres Docker ou tarefas de CI sem instalá-lo em todo o sistema
• Instalar o Node.js em uma máquina sem acesso à rede usando downloads em cache

Início rápido

1. 1

   Execute o script de instalação com curl (revise-o antes ou use o comando oficial de instalação do README)

2. 2

   Carregue o nvm no perfil do shell e, em seguida, instale uma versão do Node.js

   nvm install 24
3. 3

   Alterne para uma versão instalada do Node.js

   nvm use 22

Antes de usar

• !Não há suporte para Windows nativo; use WSL, Git Bash ou Cygwin.
• !Fish shell não é compatível.

Tópicos

Perguntas frequentes

O que é nvm?

Script Bash compatível com POSIX para instalar e alternar entre várias versões do Node.js por usuário e por shell. nvm é um gerenciador de versões de linha de comando para Node.js. Ele instala versões do Node.js em um diretório por usuário, permite alternar a versão ativa com um único comando e mantém conjuntos separados de pacotes npm instalados globalmente para cada versão. Como é carregado como uma função do shell, funciona em sh, bash, zsh, dash e ksh, em vez de ser um binário independente.

nvm é gratuito? Qual é a licença?

nvm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

nvm ainda é mantido?

Manutenção ativa. O último commit de nvm foi em 10 de out. de 2026.

Para que posso usar nvm?

Trabalhar em vários projetos que exigem versões diferentes do Node.js Fixar a versão do Node da equipe com um arquivo .nvmrc no repositório Configurar o Node.js em contêineres Docker ou tarefas de CI sem instalá-lo em todo o sistema Instalar o Node.js em uma máquina sem acesso à rede usando downloads em cache

Como instalar nvm?

Execute o script de instalação com curl (revise-o antes ou use o comando oficial de instalação do README) Carregue o nvm no perfil do shell e, em seguida, instale uma versão do Node.js: nvm install 24 Alterne para uma versão instalada do Node.js: nvm use 22

Onde consigo nvm?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/nvm-sh/nvm