Como Instalar e Usar o npm no Ubuntu: Um Guia Completo para Iniciantes (2025)

1. Introdução

Por que usar npm no Ubuntu?

Uma das ferramentas essenciais tanto para desenvolvimento frontend quanto backend é o npm (Node Package Manager). Amplamente usado como o gerenciador de pacotes padrão para Node.js, o npm facilita a instalação e o gerenciamento de bibliotecas e ferramentas JavaScript.

Usar npm no Ubuntu aproveita a velocidade do Linux e seu gerenciamento de pacotes flexível, melhorando significativamente a eficiência do desenvolvimento. O Ubuntu é uma distribuição popular entre desenvolvedores, utilizada para tudo, desde operações de servidor até ambientes de desenvolvimento local.

Ao trabalhar com frameworks baseados em Node.js, como Vue.js, React ou Next.js, é comum usar npm para gerenciar pacotes. Configurar essas ferramentas no Ubuntu fornece um ambiente de desenvolvimento mais estável e com menos problemas em comparação ao Windows ou macOS.

Propósito deste Artigo

Este artigo guiará você na instalação do npm no Ubuntu e no domínio de seu uso básico. É especialmente útil para os seguintes leitores:

• Desenvolvedores que são novos no Ubuntu
• Quem está tendo dificuldades para configurar Node.js e npm
• Aqueles que desejam aprender a usar npm de forma estruturada

Abordaremos vários métodos de instalação, discutindo os prós e contras de cada um. Também trataremos erros comuns, dicas de solução de problemas e uma coleção de comandos úteis para que você possa começar a usar npm no Ubuntu de forma tranquila.

2. Como Instalar Node.js e npm no Ubuntu

Para usar npm no Ubuntu, primeiro é necessário instalar o Node.js. Isso porque o npm vem incluído no Node.js, de modo que ao instalar o Node.js o npm já fica disponível.

Nesta seção, apresentaremos três métodos principais para instalar Node.js e npm no Ubuntu. Cada método tem suas próprias características, portanto é importante escolher aquele que melhor se adapta ao seu estilo e objetivos de desenvolvimento.

Método 1: Usando o Repositório Oficial do Ubuntu

Passos

O Node.js está disponível nos repositórios padrão do Ubuntu. Este método é o mais fácil e amigável para iniciantes.

sudo apt update
sudo apt install nodejs npm

Após a instalação, você pode verificar as versões instaladas com os seguintes comandos:

node -v
npm -v

Prós

• Comandos simples, fáceis de seguir
• Versão segura e estável fornecida

Contras

• A versão do Node.js/npm pode estar desatualizada, portanto alguns recursos mais recentes podem não estar disponíveis

Método 2: Usando o PPA NodeSource

É possível obter versões mais recentes do Node.js e npm usando o repositório NodeSource, que está alinhado com o suporte oficial do Node.js.

Passos (Exemplo: Instalar Node.js 18.x)

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

O npm será instalado automaticamente junto com o Node.js.

Prós

• Acesso a versões mais novas, porém estáveis
• Instalação simples e funciona bem no Ubuntu

Contras

• Como qualquer PPA, pode ser necessário gerenciar dependências do sistema manualmente

Método 3: Usando nvm (Node Version Manager)

Se você deseja alternar entre múltiplas versões do Node.js, usar nvm é o método mais flexível e conveniente.

Passos

Primeiro, instale o nvm:

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

Em seguida, recarregue seu shell e instale o Node.js usando nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

O npm também será instalado automaticamente com o Node.js.

Prós

• Alterna facilmente entre diferentes versões do Node.js
• Define a versão por projeto para melhor compatibilidade
• Não afeta o ambiente do sistema inteiro, sendo seguro de usar

Contras

• Um pouco mais complexo de configurar comparado aos outros métodos
• É necessário modificar o arquivo de configuração do seu shell

Qual Método Você Deve Escolher?

Se você planeja usar npm no Ubuntu para desenvolvimento a longo prazo, nvm é o método mais recomendado. Contudo, se quiser começar rapidamente, o PPA NodeSource também é uma escolha sólida.

3. Uso Básico do npm

Depois de configurar o Node.js e o npm no Ubuntu, o próximo passo é começar a gerenciar pacotes usando o npm. O npm é uma ferramenta poderosa usada para instalar, atualizar e remover pacotes JavaScript.

Nesta seção, apresentaremos os comandos npm mais usados para ajudá‑lo a começar.

Instalando Pacotes

Instalação Local

Pacotes que são usados apenas dentro de um projeto específico devem ser instalados localmente. Esta é a abordagem padrão e instala o pacote no diretório node_modules, com detalhes registrados em package.json.

npm install package-name

Exemplo: instalar axios

npm install axios

Somente scripts dentro do mesmo projeto poderão usar este pacote.

Instalação Global

Ferramentas que são usadas em todo o sistema, como aplicativos de linha de comando, devem ser instaladas globalmente.

npm install -g package-name

Exemplo: instalar http-server globalmente

sudo npm install -g http-server

No Ubuntu, pode ser necessário usar sudo ao usar a opção -g.

Desinstalando Pacotes

Se um pacote não for mais necessário, você pode removê‑lo usando os comandos a seguir.

Remover um Pacote Local

npm uninstall package-name

Remover um Pacote Global

sudo npm uninstall -g package-name

Atualizando Pacotes

Para atualizar pacotes para a versão mais recente, você pode usar estes comandos.

Atualizar um Pacote Específico

npm update package-name

Atualizar Todas as Dependências de Uma Vez

npm update

Observe que isso atualiza os pacotes apenas dentro do intervalo de versões especificado em package.json, portanto verifique sempre os números das versões.

Instalando Pacotes de Desenvolvimento (–save-dev)

Pacotes usados apenas em ambientes de desenvolvimento — como ferramentas de teste ou de build — devem ser instalados com a opção --save-dev.

npm install --save-dev package-name

Exemplo: instalar jest como dependência de desenvolvimento

npm install --save-dev jest

Isso adicionará o pacote à seção devDependencies do seu package.json.

Visualizando Pacotes Instalados

Listar Pacotes Locais

npm list

Listar Pacotes Globais

npm list -g --depth=0

Ao especificar --depth=0, apenas os pacotes de nível superior são mostrados, facilitando a leitura da lista.

Gerenciando Dependências do Projeto com package.json

O arquivo package.json, localizado na raiz do seu projeto, desempenha um papel fundamental nos fluxos de trabalho do npm. Ele armazena nomes de pacotes, versões e scripts personalizados, servindo como o arquivo de configuração do projeto.

Você pode criar um arquivo package.json usando o comando a seguir:

npm init

Isso executa uma configuração interativa. Se preferir pular as perguntas e usar os valores padrão:

npm init -y

Isso gerará automaticamente um package.json com as configurações padrão.

4. Problemas Comuns e Como Corrigi‑los

Ao usar o npm no Ubuntu, você pode ocasionalmente encontrar erros ou comportamentos inesperados. Esta seção cobre alguns dos problemas mais comuns — especialmente aqueles que iniciantes costumam enfrentar — e como resolvê‑los.

Erros de Permissão

Sintomas

EACCES: permission denied

Esse erro costuma aparecer ao tentar uma instalação global com npm.

Causa

Isso ocorre quando o usuário atual não tem permissão de gravação no diretório onde o npm está tentando instalar os pacotes. No Ubuntu, por razões de segurança, diretórios do sistema como /usr/lib/node_modules exigem sudo para serem modificados.

Soluções

• Execute o comando de instalação com sudo :

  sudo npm install -g package-name
  

• Ou altere o diretório de instalação global para o seu diretório de usuário, evitando o uso de sudo :

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Em seguida, adicione o seguinte ao seu ~/.bashrc ou ~/.profile para atualizar o PATH:

export PATH="$HOME/.npm-global/bin:$PATH"

Para aplicar as alterações, reinicie o terminal ou execute:

source ~/.bashrc

Comando npm Não Encontrado

Sintomas

command not found: npm

Mesmo após a instalação, o terminal pode não reconhecer o comando npm.

Causas

• Node.js e npm não foram instalados corretamente
• O local do binário não está incluído no seu PATH

Soluções

Primeiro, verifique se o binário do npm está disponível:

which npm

Se nada for retornado, reinstale o npm ou verifique se suas variáveis de ambiente estão configuradas corretamente. Se você estiver usando nvm, certifique-se de que o arquivo de configuração do shell (por exemplo, .bashrc ou .zshrc) inclui o código de inicialização do nvm:

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

Pacote Não Instala / Conflito de Versão

Sintomas

• A instalação de um pacote resulta em erros de incompatibilidade de versão
• npm install aciona uma enxurrada de avisos

Causa

O npm exibe erros ou avisos quando as dependências de pacotes conflitam. Isso frequentemente ocorre em projetos mais antigos onde pacotes depreciados ainda estão listados.

Soluções

• Tente instalar a versão mais recente:

  npm install package-name@latest
  

• Verifique a árvore de dependências do pacote:

  npm ls package-name
  

• Instalação forçada (não recomendado a menos que necessário):

  npm install --legacy-peer-deps
  

• Limpe seu projeto e reinstale as dependências:

  rm -rf node_modules package-lock.json
  npm install
  

Outras Dicas Úteis de Depuração

• npm doctor : Verifica a configuração do seu sistema e ambiente

  npm doctor
  

• npm audit : Analisa problemas de segurança e sugere correções

  npm audit
  npm audit fix
  

A maioria dos erros do npm no Ubuntu é exibida em inglês, o que pode parecer esmagador no início. Mas lendo as mensagens com cuidado e respondendo passo a passo, você geralmente pode resolver o problema rapidamente.

5. Perguntas Frequentes (FAQ)

Esta seção responde a perguntas comuns que novos usuários de Ubuntu + npm frequentemente têm. Use-a para prevenir problemas antes que ocorram e para construir um ambiente de desenvolvimento mais suave.

Q1. Como posso atualizar o npm para a versão mais recente no Ubuntu?

A1.

Você pode atualizar o npm para a versão mais recente usando o seguinte comando:

sudo npm install -g npm@latest

Se você estiver usando nvm, não precisa de sudo:

npm install -g npm@latest

Para verificar a versão instalada:

npm -v

Q2. Qual é a diferença entre instalações globais e locais do npm?

A2.

• Instalação local:
• Usada para gerenciar dependências dentro de um projeto específico
• Pacotes são instalados no diretório node_modules
• Facilmente compartilhável com colegas de equipe via package.json
• Instalação global:
• Usada para ferramentas que você deseja acessíveis em todo o sistema (por exemplo, ferramentas CLI)
• Pacotes são geralmente instalados em /usr/lib/node_modules no Ubuntu
• sudo pode ser necessário para a instalação

Q3. Quais são os benefícios de usar o nvm?

A3.

nvm (Node Version Manager) permite que você mude entre múltiplas versões do Node.js facilmente. Aqui estão os benefícios:

• Ideal para gerenciar diferentes versões para diferentes projetos
• Não afeta configurações em todo o sistema, tornando-o mais seguro
• O npm também é gerenciado por versão do Node, oferecendo configurações de ambiente flexíveis

Q4. O que devo fazer se as dependências do npm ficarem bagunçadas?

A4.

Primeiro, tente deletar node_modules e package-lock.json, depois reinstale tudo:

rm -rf node_modules package-lock.json
npm install

Se isso não ajudar, tente usar o comando npm ci para uma reinstalação limpa (recomendado para pipelines CI/CD).

Q5. É normal ver “WARN” ou “audit” na saída do npm?

A5.

Avisos (WARN) não são fatais, mas eles sinalizam problemas potenciais como dependências desatualizadas ou recursos depreciados.

Para avisos relacionados à segurança, você pode tentar corrigi-los automaticamente usando:

npm audit fix

Idealmente, revise as mudanças e commite-as com Git para manter um código base seguro e estável.

Q6. Que tipo de projetos posso construir com npm no Ubuntu?

A6.

npm é sua porta de entrada para o ecossistema JavaScript. Aqui estão apenas algumas coisas que você pode construir no Ubuntu:

• Aplicativos frontend usando frameworks como React, Vue ou Svelte
• Geradores de sites estáticos como Next.js ou Nuxt
• APIs backend usando Express ou NestJS
• Ferramentas CLI personalizadas
• Ambientes de teste com Jest ou Mocha

Ao usar npm no Ubuntu, você pode aproveitar todo o poder do ecossistema de código aberto para construir aplicativos eficientes, escaláveis e modernos.

6. Resumo: Dominando npm no Ubuntu

Neste artigo, cobrimos tudo o que você precisa saber para instalar e começar a usar npm de forma eficaz no Ubuntu. Dos métodos de instalação aos comandos básicos, aqui está um resumo rápido dos pontos principais.

Principais Lições

• O que é npm? – Um gerenciador de pacotes incluído com Node.js que aumenta significativamente a produtividade no desenvolvimento
• Como instalar npm no Ubuntu: – Você pode instalá-lo via repositório oficial, NodeSource PPA ou nvm dependendo das suas necessidades
• Recursos principais: – Comandos fáceis para instalar, remover, atualizar e gerenciar dependências
• Solução de problemas: – Dicas para resolver erros de permissão, conflitos de versão e mais
• Seção de FAQ: – Respostas claras para perguntas comuns enfrentadas durante o desenvolvimento no mundo real

Uma Nota para Iniciantes

Ubuntu e npm formam uma ótima dupla para o desenvolvimento web moderno. Embora você possa enfrentar alguns erros ou confusões no início, trabalhar através desses problemas aprofundará seu entendimento e ajudará você a crescer como desenvolvedor.

A coisa mais importante é experimentar as coisas na prática. Executar cada comando, ler a saída e aprender com os erros construirá rapidamente sua confiança.

Isso conclui nosso guia para usar npm no Ubuntu. Esperamos que ajude você a construir um ambiente de desenvolvimento sólido e acelere sua jornada de aprendizado de habilidades.

Continuaremos compartilhando mais dicas de Linux e tutoriais de desenvolvimento frontend, então sinta-se à vontade para bookmarkar este site ou compartilhá-lo nas redes sociais!