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

Alternar entre versões do Node.js pode ser complicado. Você provavelmente precisará de diferentes versões do Node se for um desenvolvedor trabalhando em múltiplos projetos. O Node Version Manager (NVM) simplifica isso. Este guia explicará claramente como instalar o NVM, gerenciar múltiplas versões do Node e solucionar problemas comuns no macOS.

O que é o NVM e Por Que Usá-lo?

O NVM é um script de shell que gerencia múltiplas instalações do Node.js. Ele permite que desenvolvedores alternem rapidamente entre versões do Node sem afetar outros componentes do sistema. Essa flexibilidade ajuda quando projetos exigem diferentes ambientes Node.

Instalando o NVM no macOS

Siga estes passos simples para instalar o NVM no seu Mac:

1. Baixar e Instalar o NVM:

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

2. Atualizar o Perfil do Shell: Verifique se as seguintes linhas estão no seu ~/.zshrc ou ~/.bash_profile:

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

Recarregue seu shell:

source ~/.zshrc

3. Verificar a Instalação:

nvm --version

Instalando as Versões Mais Recentes do Node.js

Com o NVM instalado, você pode gerenciar versões do Node facilmente.

• Versão LTS Mais Recente:

nvm install --lts

• Versão Atual Mais Recente:

nvm install node

• Versão Específica do Node:

nvm install 18.17.1

• Listar Versões Instaladas:

nvm list

Alternando Entre Versões do Node.js

Use nvm use para alternar versões:

nvm use 18

Confirme sua versão ativa do Node:

node -v

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

nvm alias default 18

Solucionando Problemas Comuns do NVM

Comando NVM Não Encontrado

• Verifique se o NVM está carregado corretamente checando seu perfil (~/.zshrc ou ~/.bash_profile).
• Recarregue seu perfil com source ~/.zshrc.

Versão do Node Não Alterna (Conflito com Homebrew)

Verifique conflitos com instalações do Homebrew:

which -a node

Remova instalações conflitantes do Node:

brew uninstall --ignore-dependencies node

Aviso do NVM (problema com npm prefix)

Remova a configuração global de prefixo do npm:

npm config delete prefix

Conclusão

Usar o NVM simplifica o gerenciamento de múltiplas versões do Node.js no macOS, permitindo que você alterne versões facilmente e evite conflitos de versão. A configuração adequada e a resolução de problemas comuns garantem um uso tranquilo.

Perguntas Frequentes