Como Alternar Versões do Node.js no Linux usando NVM (Guia Passo a Passo)

Gerenciar diferentes versões do Node.js pode se tornar complicado, especialmente se você trabalha em vários projetos que exigem configurações específicas do Node.js. O Node Version Manager (NVM) torna a alternância entre versões do Node.js no Linux fácil e organizada. Neste guia, você aprenderá exatamente como instalar o NVM, alternar entre versões do Node, definir padrões e resolver rapidamente problemas comuns.

Passo 1: Instalar o NVM no Linux

Execute este comando no seu terminal:

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

Este script baixa e instala o NVM automaticamente.

Verificar a Instalação

Recarregue seu shell:

source ~/.bashrc  # Para usuários do Bash
source ~/.zshrc   # Para usuários do Zsh

Em seguida, verifique a instalação do NVM:

nvm --version

Você deverá ver o número da versão.

Solução de problemas de instalação

Se você encontrar nvm: command not found:

• Verifique se seu ~/.bashrc ou ~/.zshrc tem estas linhas:

export NVM_DIR=""$HOME/.nvm""
[ -s ""$NVM_DIR/nvm.sh"" ] && . ""$NVM_DIR/nvm.sh""

• Depois de adicionar essas linhas, recarregue seu shell novamente.

Passo 2: Instalar e Gerenciar Versões do Node.js

Instalar a Versão Mais Recente do Node.js

Instale a versão mais recente do Node.js:

nvm install node  # versão mais recente
nvm install --lts # versão mais recente com Suporte de Longo Prazo (LTS)

Instalar uma Versão Específica do Node.js

Encontre e instale uma versão específica do Node.js (ex: 20.11.0):

nvm ls-remote
nvm install 20.11.0

Listar Versões Instaladas

Verifique as versões do Node instaladas:

nvm ls

Passo 3: Alternar Entre Versões do Node.js

Alterne entre versões do Node.js instantaneamente:

nvm use 20.11.0

Verifique a versão ativa:

node -v

Definir uma Versão Padrão do Node.js

Defina a versão padrão do Node.js para novos terminais:

nvm alias default 20.11.0

Passo 4: Usar .nvmrc para Versões Específicas de Projetos

Crie um arquivo .nvmrc na pasta do seu projeto com a versão do Node dentro (ex: 20.11.0). Depois use:

nvm use

O NVM automaticamente seleciona a versão do arquivo .nvmrc.

Problemas Comuns e Soluções Rápidas

Versão do Node Não Muda

• Certifique-se de que não está usando uma versão do Node.js instalada no sistema por engano.
• Execute which node para confirmar que o Node gerenciado pelo NVM está ativo.
• Nunca use sudo para comandos NVM ou para instalar pacotes npm.

Pacotes npm Globais Ausentes Após Alternar Versões

Cada versão do Node.js gerencia seus próprios pacotes npm globais. Para migrar pacotes globais:

nvm install 20 --reinstall-packages-from=18

Substitua ""18"" pela versão do Node da qual você deseja migrar.

Atualizando o NVM

Execute o script de instalação novamente para atualizar o NVM facilmente:

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

Isso atualiza o NVM sem afetar as versões do Node instaladas.

Conclusão

Usar o NVM simplifica significativamente o gerenciamento de múltiplos ambientes Node.js. Ele permite alternância rápida, evita conflitos de versão e mantém seu fluxo de desenvolvimento no Linux tranquilo.

Perguntas Frequentes