Instalação e Gerenciamento do Node.js com NVM

Em 2025, o Node.js continua sendo uma ferramenta essencial para o desenvolvimento JavaScript. Este guia detalhado abordará não apenas a instalação do Node.js em diferentes plataformas, mas também o uso avançado do Node Version Manager (NVM) para um gerenciamento eficiente de múltiplas versões.

33 min
Gr
Gregory Serrao
Em 2025, o Node.js continua sendo uma ferramenta essencial para o desenvolvimento JavaScript. Este guia detalhado abordará não apenas a instalação do Node.js em diferentes plataformas, mas também o uso avançado do Node Version Manager (NVM) para um gerenciamento eficiente de múltiplas versões.

O que é o NVM?

O NVM (Node Version Manager) é uma ferramenta de linha de comando que permite aos desenvolvedores gerenciar múltiplas versões do Node.js com facilidade.


Principais características do NVM:

  1. Permite instalar, alternar e remover diferentes versões do Node.js em uma única máquina
  2. Fornece uma interface simples para gerenciar versões do Node.js via comandos no terminal
  3. Possibilita executar múltiplas versões do Node.js no mesmo computador
  4. Facilita a troca entre versões do Node.js para diferentes projetos, evitando problemas de compatibilidade
  5. Gerencia também as instalações do npm (Node Package Manager) correspondentes a cada versão do Node.js
  6. Funciona em sistemas Unix, macOS e Windows (via WSL)


O NVM é especialmente útil para desenvolvedores que trabalham em projetos que requerem versões específicas do Node.js, permitindo alternar entre elas de forma simples e evitando conflitos de versão.

Nota Alternativa: Se preferir uma instalação tradicional, você pode baixar o instalador oficial diretamente no site oficial do Node.js em https://nodejs.org, onde encontrará versões específicas para cada sistema operacional com instaladores pré-configurados.


Instalação do NVM

No macOS e Linux:

Abra o Terminal e execute o comando de instalação:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

Atualize o perfil do shell:

source ~/.bashrc # Para bash
source ~/.zshrc # Para zsh

Verifique a instalação:

nvm --version

No Windows:

Baixe o instalador nvm-windows do GitHub, execute o instalador e siga as instruções.


Abra um novo prompt de comando e verifique:

nvm version

Instalando Node.js com NVM

Após a instalação do NVM, você pode gerenciar facilmente diferentes versões do Node.js.


Instalando a versão LTS mais recente:

nvm install --lts

Instalando uma versão específica:

nvm install 16.14.0

Listando versões instaladas:

nvm ls

Alternando entre versões:

nvm use 16.14.0

Configuração Avançada em projetos

Para garantir consistência em projetos de equipe, crie um arquivo .nvmrc na raiz do projeto:

16.14.0

Então, qualquer membro da equipe pode simplesmente executar:

nvm use

Dicas e Boas Práticas

  1. Utilize sempre a versão LTS para projetos de produção
  2. Mantenha o NVM atualizado regularmente
  3. Implemente .nvmrc em todos os projetos para consistência da equipe
  4. Faça backup das configurações globais do npm antes de alternar versões
  5. Utilize scripts npm para automatizar a troca de versões em diferentes ambientes


Recursos Avançados do NVM

Aliases Personalizados:

nvm alias myproject 14.17.0
nvm use myproject

Execução de Comandos com Versões Específicas:

nvm exec 14.17.0 node script.js

Instalação de Pacotes Globais por Versão:

nvm use 14.17.0
npm install -g yarn

Solução de Problemas Comuns

Conflitos de PATH: Verifique a configuração no arquivo de perfil do shell.


Permissões no macOS/Linux:

sudo chown -R $(whoami) ~/.nvm

Desempenho no Windows: Considere usar o Windows Subsystem for Linux (WSL) para uma experiência mais próxima do Unix.


Conclusão

Em 2025, o uso eficiente do NVM para gerenciar instalações do Node.js é mais crucial do que nunca. Com a rápida evolução do ecossistema JavaScript, a capacidade de alternar facilmente entre versões do Node.js e gerenciar múltiplos ambientes de desenvolvimento é essencial para desenvolvedores modernos. Ao dominar o NVM e seguir as melhores práticas descritas neste guia, você estará bem equipado para enfrentar os desafios do desenvolvimento Node.js contemporâneo, garantindo flexibilidade, consistência e eficiência em seus projetos.

Cadastre-se para novos posts