Como instalar o Node.js no Ubuntu: Um guia completo com APT, NodeSource e nvm

markdown.## 1. Introdução: Por que usar Node.js no Ubuntu?

Excelente Compatibilidade entre Ubuntu e Node.js

Node.js é uma plataforma para executar JavaScript no lado do servidor e é amplamente utilizada para aplicações web e desenvolvimento de ferramentas. Ubuntu, por sua vez, é uma distribuição Linux confiável por muitos desenvolvedores e administradores de servidores. Ao combinar os dois, você pode criar um ambiente de desenvolvimento que se destaca em estabilidade, flexibilidade e velocidade.

Instalar Node.js no Ubuntu oferece as seguintes vantagens:

• Um sistema operacional leve com sobrecarga mínima, permitindo uso eficiente dos recursos do sistema
• Um ambiente unificado baseado em Linux, desde o desenvolvimento até testes e produção
• Alta compatibilidade com Node.js e integração fluida com ferramentas como npm e nvm

Por essas razões, a combinação de Ubuntu e Node.js é altamente atraente como ambiente de desenvolvimento tanto para frontend quanto para backend.

Público‑Alvo e Propósito deste Artigo

Este artigo foi escrito para os seguintes leitores:

• Aqueles que desejam usar Node.js no Ubuntu pela primeira vez
• Aqueles que querem saber qual método de instalação é o melhor
• Aqueles que desejam usar a versão mais recente do Node.js, mas não têm certeza sobre a configuração

Ao ler este artigo, você será capaz de comparar três diferentes métodos de instalação do Node.js no Ubuntu e escolher a abordagem mais adequada com base em seus objetivos e nível de habilidade. Além disso, este guia cobre ferramentas relacionadas como npm e yarn, bem como soluções para erros comuns, ajudando‑o a usar um ambiente Node.js com confiança.

2. Visão geral dos métodos de instalação do Node.js no Ubuntu

Três métodos de instalação, cada um com suas próprias características

Existem três maneiras principais de instalar o Node.js no Ubuntu:

1. Instalar o pacote padrão via APT (Advanced Package Tool)
2. Instalar via NodeSource PPA (Personal Package Archive)
3. Usar nvm (Node Version Manager) para gerenciamento flexível de versões

Cada método tem suas próprias vantagens e desvantagens, e a melhor escolha depende do seu caso de uso e da configuração do sistema. A tabela a seguir resume suas características.

Tabela comparativa dos métodos de instalação do Node.js

Por que a comparação é importante?

Ubuntu prioriza a estabilidade, o que significa que as versões de software no repositório APT tendem a ser conservadoras. Como resultado, usuários que desejam os recursos mais recentes do Node.js ou precisam testar várias versões devem considerar opções além do APT.

Por outro lado, se seu objetivo é simplesmente experimentar o Node.js rapidamente ou evitar configurações extras em um servidor de produção, o método APT pode ser suficiente.

Qual você deve escolher?

Em conclusão, para desenvolvedores ou qualquer pessoa que planeje usar Node.js a longo prazo, instalar via nvm é a abordagem mais recomendada.
Os motivos incluem:

• Troca fácil entre as versões mais recentes e as mais antigas
• npm é instalado automaticamente
• Menos problemas de permissão (não requer sudo)

3. Método ①: Instalando Node.js facilmente com APT (Ubuntu Oficial)

O que é APT? O sistema de gerenciamento de pacotes padrão no Ubuntu

APT (Advanced Package Tool) é o sistema de gerenciamento de pacotes padrão usado pelo Ubuntu e outras distribuições Linux baseadas em Debian. Com o APT, você pode instalar, atualizar e remover softwares facilmente usando um único comando.

O repositório oficial do Ubuntu inclui pacotes de Node.js, o que significa que você pode instalar o Node.js imediatamente sem nenhuma preparação especial.

Passos de instalação

1. Atualize a lista de pacotes do APT.

   sudo apt update
   

2. Instale o Node.js e o npm.

   sudo apt install nodejs npm
   

3. Verifique a instalação.

   node -v
   npm -v
   

Se as informações de versão forem exibidas, a instalação foi bem‑sucedida.

Vantagens: Simples e Seguro

• Altamente confiável, pois usa o repositório oficial do Ubuntu
• Comandos simples que são fáceis para iniciantes
• Integrado às atualizações do sistema via APT

Desvantagens: A Versão Pode Estar Desatualizada

Como o APT prioriza a estabilidade, a versão do Node.js disponível pode estar várias gerações atrás.

Por exemplo, no Ubuntu 22.04, a versão do Node.js instalada via APT pode ser a 12 ou 14, o que significa que os recursos mais recentes e as melhorias de segurança podem não estar incluídos.

Esse método também não é adequado se você precisar usar múltiplas versões do Node.js em diferentes projetos.

Quem Deve Usar Este Método

• Iniciantes que querem experimentar o Node.js imediatamente
• Ambientes de produção onde uma versão estável é suficiente
• Usuários que não precisam de múltiplas versões do Node.js

4. Método ②: Instalando a Versão Mais Recente com NodeSource PPA

O que é NodeSource?

NodeSource é um provedor confiável que entrega versões estáveis e recentes do Node.js rapidamente, independentemente da equipe oficial do Node.js. É especialmente útil para usuários de Ubuntu e Debian que desejam instalar versões mais novas do Node.js enquanto continuam usando o APT.

Esse método é recomendado no site oficial do Node.js e é amplamente usado em ambientes corporativos.

Passos de Instalação (Exemplo: Node.js 18.x)

1. Atualize a lista de pacotes.

   sudo apt update
   

2. Instale o curl caso ainda não esteja instalado.

   sudo apt install curl
   

3. Execute o script de configuração do NodeSource.

   curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
   

4. Instale o Node.js.

   sudo apt install -y nodejs
   

5. Verifique a instalação.

   node -v
   npm -v
   

Vantagens: Use a Versão Mais Recente com APT

• Instalação fácil da versão estável mais recente do Node.js
• Gerenciamento familiar baseado em APT
• npm é instalado automaticamente

Desvantagens: Requer a Adição de um PPA

• Um pouco mais de etapas em comparação com a instalação padrão via APT
• É necessário avaliar a confiabilidade da fonte (NodeSource é geralmente segura)

Quem Deve Usar Este Método

• Desenvolvedores que desejam uma versão estável e atualizada do Node.js
• Usuários que consideram o repositório do Ubuntu insuficiente, mas não querem usar nvm
• Aqueles que desejam manter a gestão centralizada de pacotes baseada em APT

5. Método ③: Gerenciamento Flexível de Versões com nvm (Recomendado)

O que é nvm? Uma Ferramenta Poderosa para Gerenciar Versões do Node.js

nvm (Node Version Manager) é uma ferramenta de linha de comando que permite gerenciar e alternar entre múltiplas versões do Node.js. É especialmente útil para desenvolvedores que precisam de versões diferentes por projeto ou que desejam testar tanto as versões mais recentes quanto as LTS.

Com nvm, você pode criar um ambiente de desenvolvimento flexível totalmente dentro da sua conta de usuário, sem instalar o Node.js de forma global no sistema.

Instalando nvm

1. Execute o script de instalação usando curl.

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

2. Recarregue o arquivo de configuração do seu shell.

   source ~/.bashrc
   

Ou, se você estiver usando Zsh:

source ~/.zshrc

3. Verifique se o nvm foi instalado.

   command -v nvm
   

Se nvm for exibido, a instalação foi bem‑sucedida.

Instalando Node.js com nvm

1. Instale a versão LTS:

   nvm install --lts
   

2. Instale uma versão específica:

   nvm install 18
   

3. Troque a versão ativa:

   nvm use 18
   

4. Defina a versão padrão:

   nvm alias default 18
   

5. Verifique as versões:

   node -v
   npm -v
   

Vantagens: Máxima Flexibilidade e Controle

• Múltiplas versões podem coexistir e ser trocadas instantaneamente
• npm é instalado automaticamente
• Não requer sudo, reduzindo problemas de permissão
• Não altera o ambiente do sistema, ideal para desenvolvimento

Desvantagens: Configuração Inicial Requer Atenção

• nvm não funcionará se os arquivos de configuração do shell não forem carregados corretamente
• Instalado por usuário, não de forma global

Quem Deve Usar Este Método

• Desenvolvedores que precisam alternar entre versões do Node.js
• Usuários que gerenciam múltiplos projetos com diferentes requisitos
• Iniciantes que desejam evitar problemas relacionados a permissões

6. Usando npm e yarn

O que é npm?

npm (Node Package Manager) é uma ferramenta essencial para gerenciar pacotes do Node.js. Ele permite instalar e gerenciar facilmente bibliotecas e ferramentas publicadas por desenvolvedores em todo o mundo.

Quando o Node.js é instalado via APT, NodeSource ou nvm, o npm geralmente é instalado automaticamente.

Verifique a versão:

npm -v

Comandos básicos do npm

O que é yarn?

yarn é uma alternativa ao npm desenvolvida pelo Facebook, projetada para gerenciamento de pacotes mais rápido e confiável. Seus comandos são amplamente compatíveis com o npm.

Instalando yarn (via npm)

npm install -g yarn

Verifique a instalação:

yarn -v

Comandos básicos do yarn

npm vs yarn: Qual você deve usar?

O npm moderno (v7 e posteriores) melhorou significativamente, portanto ambas as opções são geralmente adequadas. É melhor seguir o que seu projeto ou equipe já utiliza.

7. Erros comuns e solução de problemas

Problemas comuns e soluções

■ node: command not found

Causa:
Node.js não está instalado corretamente, ou o PATH não está configurado. Isso costuma acontecer após instalar o nvm sem recarregar a configuração do shell.

Solução:

• Recarregue o arquivo de configuração do shell:

  source ~/.bashrc
  

• Se o problema persistir, faça logout e login novamente ou reinicie

■ E: Unable to locate package nodejs

Causa:
A lista de pacotes do APT está desatualizada ou o PPA correto não foi adicionado.

Solução:

• Atualize a lista do APT:

  sudo apt update
  

• Se estiver usando NodeSource, execute novamente o script de configuração

■ npm ERR! permission denied

Causa:
Permissões insuficientes ao instalar pacotes npm globais.

Solução:

• Use sudo (não é sempre recomendado):

  sudo npm install -g <package-name>
  

• Usar nvm é a melhor prática para evitar problemas de permissão

■ nvm: command not found

Causa:
nvm está instalado, mas a configuração do shell não foi carregada.

Solução:

• Certifique-se de que o nvm seja carregado no seu arquivo de configuração do shell
• Carregue-o manualmente:

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

Melhores práticas para evitar problemas

• Sempre verifique as configurações do PATH
• Usar nvm ajuda a evitar a maioria dos problemas relacionados ao ambiente
• Preste atenção à compatibilidade entre Ubuntu e versões do Node.js

8. Perguntas Frequentes (FAQ)

Q1. Como posso verificar minha versão do Node.js?

A. Execute o seguinte comando no terminal:

node -v

Para verificar o npm também:

npm -v

Q2. Como posso usar múltiplas versões do Node.js no Ubuntu?

A. Usar nvm é a abordagem mais fácil e segura. Após a instalação, você pode alternar versões assim:

nvm install 16
nvm use 16

Q3. O Node.js instalado via nvm não está ativo. Por quê?

A. Na maioria dos casos, o arquivo de configuração do shell não foi carregado. Execute:

source ~/.bashrc

Ou, para Zsh:

source ~/.zshrc

Q4. Qual é a diferença entre npm e yarn?

A. A funcionalidade central deles é semelhante, mas yarn oferece instalações mais rápidas usando cache e bloqueio explícito de dependências via yarn.lock. O npm moderno melhorou significativamente, então ambas as opções funcionam bem.

Q5. Como o Node.js, Deno e Bun diferem?

A. Deno e Bun são runtimes alternativos projetados para superar limitações do Node.js.

• Deno : suporte nativo a TypeScript, segurança aprimorada, biblioteca padrão integrada
• Bun : execução mais rápida e gerenciamento de pacotes integrado

No entanto, o Node.js continua a escolha mais prática devido ao seu vasto ecossistema npm.

9. Conclusão: Escolha o método de instalação certo para suas necessidades

Existem várias maneiras de instalar o Node.js no Ubuntu, cada uma com forças e casos de uso claros. Este artigo apresentou três métodos representativos e explicou como escolher o mais adequado.

APT (Oficial do Ubuntu)

• Prós: Mais fácil e seguro
• Contras: A versão pode estar desatualizada
• Recomendado para: Iniciantes que querem um início rápido

NodeSource PPA

• Prós: Instala versões mais recentes enquanto usa o APT
• Contras: Requer a adição de um PPA
• Recomendado para: Desenvolvedores que querem uma versão recente estável

nvm (Node Version Manager)

• Prós: Troca flexível de versões e ambiente limpo
• Contras: Configuração ligeiramente mais complexa
• Recomendado para: Desenvolvedores que lidam com múltiplos projetos

Este guia também cobriu npm, yarn e dicas comuns de solução de problemas. Embora a instalação do Node.js possa parecer complexa no início, escolher o método certo facilita a construção de um ambiente de desenvolvimento estável no Ubuntu.

Se você planeja expandir seus projetos ainda mais, usar o nvm como base ajudará você a escalar para desenvolvimento em equipe e fluxos de trabalho CI/CD.