Fundamentos do Node.js

0/23 aulas0%
pratica

Instalação do Node.js e NVM (Node Version Manager)

Aprenda sobre instalação do node.js e nvm (node version manager)

30 min
Aula 2 de 6

🚀 Instalação do Node.js e NVM (Node Version Manager)

Olá, futuro desenvolvedor Node.js! 👋 Nesta aula prática, vamos configurar o ambiente de desenvolvimento essencial para começar a construir aplicações com Node.js. Aprenderemos a instalar o Node.js de forma eficiente e, mais importante, a gerenciar suas versões usando o NVM (Node Version Manager).

🎯 Introdução

O Node.js é um ambiente de execução JavaScript de código aberto e multiplataforma que permite aos desenvolvedores construir aplicações de servidor, ferramentas de linha de comando e muito mais, usando a mesma linguagem que domina o desenvolvimento web no lado do cliente.

À medida que você avança em sua jornada de desenvolvimento, é muito comum trabalhar em diferentes projetos que podem exigir diferentes versões do Node.js. Por exemplo, um projeto legado pode precisar da versão 14, enquanto um novo projeto aproveita os recursos da versão 20. Tentar gerenciar isso manualmente pode ser um pesadelo! 😱

É aí que entra o NVM (Node Version Manager). O NVM é uma ferramenta de linha de comando que permite instalar, gerenciar e alternar entre múltiplas versões do Node.js em sua máquina. Ele é indispensável para qualquer desenvolvedor Node.js sério, garantindo flexibilidade e evitando conflitos de versão.

Nesta aula, você vai:

  • Entender a importância do NVM.
  • Instalar o NVM em seu sistema operacional.
  • Usar o NVM para instalar e gerenciar versões do Node.js.
  • Verificar suas instalações.

Vamos colocar as mãos na massa! 💻

🛠️ Explicação Detalhada e Instalação

1. Por que usar o NVM?

Imagine a seguinte situação:

  • Você está trabalhando no Projeto A que foi construído com Node.js v16.
  • Você precisa começar um novo Projeto B que exige Node.js v20 para aproveitar os recursos mais recentes.
  • Mais tarde, você precisa dar manutenção no Projeto A novamente.

Sem o NVM, você teria que desinstalar e reinstalar versões diferentes do Node.js repetidamente, o que é ineficiente e propenso a erros. Com o NVM, você pode simplesmente:

# Para o Projeto A
nvm use 16
 
# Para o Projeto B
nvm use 20

Simples assim! ✨

2. Instalação do NVM

A instalação do NVM varia um pouco dependendo do seu sistema operacional. Siga as instruções abaixo para o seu ambiente.

🍎🐧 Para macOS e Linux

A forma recomendada de instalar o NVM é usando o curl ou wget para executar o script de instalação oficial. Este script clona o repositório do NVM para um diretório específico (~/.nvm) e adiciona as configurações necessárias ao seu shell profile (como .bashrc, .zshrc, ou .profile).

  1. Abra seu terminal (Terminal no macOS, ou qualquer terminal no Linux).

  2. Execute o comando de instalação:

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

    Ou, se preferir wget:

    # Usando wget
    wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

    💡 Nota: Verifique a página oficial do NVM no GitHub (nvm-sh/nvm) para a versão mais recente do script de instalação, substituindo v0.39.7 se houver uma versão mais nova.

  3. Reinicie seu terminal ou execute o comando source: Após a instalação, o script tentará adicionar as linhas necessárias ao seu arquivo de configuração do shell. Para que as mudanças tenham efeito na sessão atual, você precisará recarregar seu perfil do shell.

    # Se você usa Bash (comum)
    source ~/.bashrc
     
    # Se você usa Zsh (comum no macOS moderno)
    source ~/.zshrc
     
    # Se você usa outro shell, pode ser ~/.profile ou ~/.bash_profile

    A maneira mais garantida é simplesmente fechar e reabrir seu terminal.

  4. Verifique a instalação: Para confirmar que o NVM foi instalado corretamente, execute:

    nvm --version

    Você deverá ver o número da versão do NVM. Se receber um erro como "command not found", certifique-se de ter reiniciado seu terminal ou executado o comando source corretamente.

🪟 Para Windows

O NVM oficial não oferece suporte nativo para Windows. No entanto, existe um projeto excelente e mantido pela comunidade chamado nvm-windows que faz o trabalho perfeitamente.

  1. Desinstale qualquer Node.js existente: Se você já tem o Node.js instalado no seu sistema Windows (via instalador MSI), é altamente recomendável desinstalá-lo completamente antes de instalar o nvm-windows para evitar conflitos. Vá em "Adicionar ou remover programas" e desinstale o Node.js.

  2. Baixe o instalador do nvm-windows: Vá para a página de releases do nvm-windows no GitHub: https://github.com/coreybutler/nvm-windows/releases

  3. Baixe o arquivo nvm-setup.zip: Procure pela versão mais recente e baixe o arquivo nvm-setup.zip.

  4. Execute o instalador: Descompacte o arquivo nvm-setup.zip e execute o nvm-setup.exe. Siga as instruções do instalador. Escolha os diretórios padrão para a instalação do NVM e para as versões do Node.js.

  5. Abra o Prompt de Comando (CMD) ou PowerShell: Importante: Não use terminais como Git Bash para os comandos do nvm-windows, pois ele pode ter problemas de compatibilidade. Use o Prompt de Comando ou PowerShell.

  6. Verifique a instalação: No Prompt de Comando ou PowerShell, execute:

    nvm --version

    Você deverá ver o número da versão do nvm-windows.

3. Usando o NVM para Gerenciar Node.js

Agora que o NVM está instalado, vamos usá-lo para instalar e alternar entre as versões do Node.js.

  1. Listar versões disponíveis do Node.js: Para ver quais versões do Node.js você pode instalar, use:

    nvm ls-remote

    Isso mostrará uma longa lista de todas as versões do Node.js disponíveis, incluindo as versões LTS (Long Term Support), que são as mais recomendadas para produção devido à sua estabilidade.

  2. Instalar uma versão específica do Node.js: Para instalar a versão LTS mais recente (recomendado para a maioria dos projetos):

    nvm install --lts

    Ou para instalar uma versão específica, por exemplo, a versão 18 (que era LTS por um tempo):

    nvm install 18

    Você também pode instalar a versão mais recente "atual" do Node.js:

    nvm install node
  3. Listar versões instaladas: Para ver quais versões do Node.js estão instaladas em sua máquina e qual está sendo usada atualmente:

    nvm ls

    A versão ativa será indicada por uma seta (->) ou um asterisco (*).

  4. Usar uma versão do Node.js: Para alternar para uma versão específica do Node.js que você já instalou:

    nvm use 18

    Após executar este comando, a versão 18 do Node.js e seu npm (Node Package Manager) associado estarão ativos em sua sessão de terminal atual.

  5. Definir uma versão padrão: Para definir uma versão do Node.js que será usada por padrão sempre que você abrir um novo terminal:

    nvm alias default 18

    Agora, sempre que você abrir um novo terminal, a versão 18 será carregada automaticamente.

  6. Verificar a versão do Node.js e NPM: Após instalar e usar uma versão, verifique se ela está ativa:

    node -v
    npm -v

    Você deverá ver as versões correspondentes ao Node.js que você selecionou com nvm use.

  7. Desinstalar uma versão do Node.js: Se você não precisa mais de uma versão específica do Node.js, pode desinstalá-la para liberar espaço:

    nvm uninstall 16

    ⚠️ Cuidado: Não desinstale a versão que está sendo usada atualmente. Alterne para outra versão primeiro.

🧪 Exercícios Práticos (Hands-on)

É hora de colocar em prática o que aprendemos! Siga estes passos para configurar seu ambiente.

Tarefas:

  • 1. Instale o NVM em seu sistema operacional.
    • Siga as instruções para macOS/Linux ou Windows.
    • Verifique a instalação com nvm --version. Se houver problemas, tente reiniciar seu terminal.
  • 2. Instale a versão LTS mais recente do Node.js.
    • Use o comando nvm install --lts.
    • Após a instalação, use esta versão: nvm use --lts.
    • Verifique se ela está ativa: node -v e npm -v.
  • 3. Instale a versão mais recente (current) do Node.js.
    • Use o comando nvm install node.
    • Após a instalação, use esta versão: nvm use node.
    • Verifique se ela está ativa: node -v e npm -v.
  • 4. Alterne para a versão LTS que você instalou anteriormente.
    • Use nvm use <versão_lts_instalada> (ex: nvm use 20).
    • Confirme a mudança com node -v.
  • 5. Defina a versão LTS como padrão.
    • Use nvm alias default <versão_lts_instalada>.
    • Feche e reabra seu terminal para verificar se a versão padrão é carregada automaticamente (node -v).
  • 6. Liste todas as versões do Node.js que você tem instaladas.
    • Use nvm ls.
  • 7. (Opcional) Desinstale a versão "current" do Node.js.
    • Certifique-se de que a versão "current" não é a versão ativa (use nvm use --lts primeiro, se necessário).
    • Use nvm uninstall node.
    • Verifique novamente com nvm ls.

Parabéns! 🎉 Você agora tem o NVM configurado e sabe como gerenciar diferentes versões do Node.js. Esta é uma habilidade fundamental que o salvará de muitos problemas no futuro.

📝 Resumo e Próximos Passos

Nesta aula, você aprendeu a importância do NVM para gerenciar múltiplas versões do Node.js e realizou a instalação e configuração em seu ambiente. Você agora é capaz de:

  • Instalar o NVM em macOS/Linux ou Windows.
  • Instalar diferentes versões do Node.js.
  • Alternar entre as versões instaladas.
  • Definir uma versão padrão.
  • Verificar suas instalações de Node.js e NPM.

Este é o primeiro passo crucial para se tornar um desenvolvedor Node.js produtivo. Com seu ambiente configurado, estamos prontos para mergulhar nos conceitos fundamentais do Node.js e começar a construir nossas primeiras aplicações!

Próximos Passos:

Na próxima aula, vamos explorar:

  • Módulo: Fundamentos do Node.js
  • Aula: Entendendo o NPM (Node Package Manager) e Estrutura Básica de Projetos

Até lá, sinta-se à vontade para experimentar com o NVM e diferentes versões do Node.js! Se tiver dúvidas, revise a documentação oficial do NVM ou procure ajuda na comunidade.

© 2025 Escola All Dev. Todos os direitos reservados.

Instalação do Node.js e NVM (Node Version Manager) - Fundamentos do Node.js | escola.all.dev.br