Como usar npm no Ubuntu: Instalação, Comandos Básicos e Guia de Solução de Problemas

.

1. Introdução

Por que usar npm no Ubuntu

Uma das ferramentas essenciais tanto para desenvolvimento frontend quanto backend é o npm (Node Package Manager). O npm é amplamente usado como a ferramenta de gerenciamento de pacotes para Node.js, permitindo que desenvolvedores instalem e gerenciem facilmente bibliotecas e ferramentas JavaScript.

Ao usar npm no Ubuntu, você pode aproveitar o desempenho leve do Linux e o gerenciamento flexível de pacotes, melhorando significativamente a eficiência do desenvolvimento. O Ubuntu é uma distribuição suportada por uma grande comunidade de desenvolvedores e é amplamente utilizada para tudo, desde operações de servidor até ambientes de desenvolvimento local.

Em particular, ao trabalhar com frameworks baseados em Node.js como Vue.js, React e Next.js, gerenciar pacotes com npm é a abordagem padrão. Configurar essas ferramentas no Ubuntu permite que você construa um ambiente de desenvolvimento estável com menos problemas em comparação ao Windows ou macOS.

Propósito deste Artigo

Este artigo fornece um guia passo a passo para instalar npm no Ubuntu e dominar seu uso básico. É especialmente destinado aos seguintes públicos:

• Desenvolvedores que são novos no Ubuntu
• Aqueles que têm dificuldades com a configuração do Node.js ou npm
• Qualquer pessoa que queira aprender npm de forma estruturada

Vários métodos de instalação são apresentados, juntamente com suas características, vantagens e desvantagens. Além disso, este guia cobre erros comuns, dicas de solução de problemas e comandos úteis para ajudar os leitores a usar npm de forma fluida no Ubuntu.

2. Instalando Node.js e npm no Ubuntu

Para usar npm no Ubuntu, você deve primeiro instalar o Node.js. Como o npm vem incluído no Node.js, instalar o Node.js automaticamente disponibiliza o npm.

A seguir, três métodos principais para instalar Node.js e npm no Ubuntu. Cada método tem suas próprias características, sendo importante escolher aquele que melhor se adapta ao seu estilo de desenvolvimento e objetivo.

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

Passos

O Node.js está disponível nos repositórios padrão do Ubuntu. Esta é a abordagem mais simples e amigável para iniciantes.

sudo apt update
sudo apt install nodejs npm

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

node -v
npm -v

Vantagens

• Comandos simples e fáceis de entender
• Versões estáveis fornecidas pelo Ubuntu

Desvantagens

• As versões do Node.js e npm costumam estar desatualizadas, portanto recursos mais recentes podem não estar disponíveis

Método 2: Usando o NodeSource PPA

Ao usar o repositório NodeSource, que acompanha de perto o suporte oficial do Node.js, você pode instalar versões mais recentes do Node.js e npm.

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

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

O npm é instalado automaticamente junto com o Node.js.

Vantagens

• Acesso a versões relativamente novas e estáveis
• Instalação fácil com boa compatibilidade no Ubuntu

Desvantagens

• Como em outros PPAs, pode ser necessário gerenciar dependências

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

Se você deseja alternar entre múltiplas versões do Node.js, usar nvm é a opção mais flexível e poderosa.

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 é instalado automaticamente junto com o Node.js.

Vantagens

• Troca livre entre versões do Node.js
• Definição de versões adequadas por projeto
• Seguro, pois não afeta o sistema globalmente

Desvantagens

• Configuração um pouco mais complexa comparada a outros métodos
• Requer edição de arquivos de configuração do shell

Qual Método Você Deve Escolher?

.

Em geral, nvm é a opção mais recomendada para desenvolvimento de npm a longo prazo no Ubuntu. No entanto, se você quiser uma configuração rápida e simples, usar o PPA do NodeSource também é uma escolha sólida.

3. Uso Básico do npm

Depois que o Node.js e o npm estiverem instalados no Ubuntu, você pode começar a gerenciar pacotes com o npm. O npm é uma ferramenta poderosa para instalar, atualizar e remover pacotes JavaScript.

Esta seção apresenta os comandos npm mais usados e as operações básicas.

Instalando Pacotes

Instalação Local

Pacotes usados apenas dentro de um projeto específico devem ser instalados localmente. Esta é a abordagem padrão. Os pacotes são instalados no diretório node_modules e registrados no package.json.

npm install package-name

Exemplo: Instalando axios

npm install axios

Somente scripts dentro do mesmo projeto podem usar pacotes instalados localmente.

Instalação Global

Ferramentas usadas em todo o sistema, como utilitários de linha de comando, devem ser instaladas globalmente.

npm install -g package-name

Exemplo: Instalando http-server globalmente

sudo npm install -g http-server

No Ubuntu, usar -g pode exigir sudo.

Desinstalando Pacotes

Removendo Pacotes Locais

npm uninstall package-name

Removendo Pacotes Globais

sudo npm uninstall -g package-name

Atualizando Pacotes

Atualizando um Pacote Específico

npm update package-name

Atualizando Todas as Dependências

npm update

As atualizações são aplicadas dentro dos intervalos de versão especificados no package.json, portanto preste atenção às restrições de versão.

Instalando Dependências de Desenvolvimento (–save-dev)

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

npm install --save-dev package-name

Exemplo: Instalando jest como dependência de desenvolvimento

npm install --save-dev jest

Isso registra o pacote em devDependencies no package.json.

Listando Pacotes Instalados

Listar Pacotes Locais

npm list

Listar Pacotes Globais

npm list -g --depth=0

Usar --depth=0 mostra apenas os pacotes de nível superior, facilitando a leitura da saída.

Gerenciando Dependências com package.json

O arquivo package.json é um componente central de projetos baseados em npm. Ele registra nomes de pacotes, versões, scripts e a configuração geral do projeto.

Você pode criá‑lo usando:

npm init

Para uma configuração simplificada com valores padrão:

npm init -y

4. Problemas Comuns e Soluções

Ao usar npm no Ubuntu, você pode encontrar erros ou comportamentos inesperados. Esta seção apresenta problemas frequentes e como resolvê‑los.

Erros de Permissão

Sintoma

EACCES: permission denied

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 pacotes. No Ubuntu, gravar em diretórios do sistema como /usr/lib/node_modules requer sudo.

Solução

• Executar com sudo :

  sudo npm install -g package-name
  

• Ou mudar o diretório de instalação global para um caminho de propriedade do usuário:

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

Adicione o seguinte ao ~/.bashrc ou ~/.profile:

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

Aplique as alterações:

source ~/.bashrc

Comando npm Não Encontrado

Sintoma

command not found: npm

Causa

• Falha na instalação do Node.js ou npm
• A variável de ambiente PATH não está configurada

Solução

Verifique o caminho:

which npm

Se nada for retornado, reinstale ou verifique as configurações do PATH. Se estiver usando nvm, certifique‑se de que o código de inicialização exista no arquivo de configuração do seu shell:

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

Falhas na Instalação de Pacotes ou Conflitos de Versão

Sintomas

.* Conflitos de versão ao instalar um pacote * Vários avisos durante npm install

Soluções

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Comandos Úteis de Depuração

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Perguntas Frequentes (FAQ)

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

R1.

sudo npm install -g npm@latest

Se você estiver usando nvm, sudo não é necessário.

Q2. Qual é a diferença entre instalação global e local?

R2.

• Instalação Local : Dependências específicas do projeto armazenadas em node_modules
• Instalação Global : Ferramentas de linha de comando (CLI) em todo o sistema, frequentemente exigindo sudo

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

R3.

nvm permite alternar entre múltiplas versões do Node.js de forma segura e eficiente, tornando‑o ideal para desenvolvimento em múltiplos projetos.

Q4. O que devo fazer se as dependências do npm falharem?

R4.

rm -rf node_modules package-lock.json
npm install

Q5. As mensagens npm WARN e audit são um problema?

R5.

Avisos não são críticos, mas indicam possíveis problemas. Para avisos relacionados à segurança, você pode tentar:

npm audit fix

Q6. O que posso construir com npm no Ubuntu?

R6.

• Frameworks de frontend (React, Vue, Svelte)
• Geradores de sites estáticos (Next.js, Nuxt)
• Aplicações backend (Express, NestJS)
• Ferramentas de linha de comando (CLI)
• Ambientes de teste

6. Conclusão: Domine o npm no Ubuntu

Este artigo abordou o essencial da instalação e uso do npm no Ubuntu, desde a configuração até a solução de problemas.

A etapa mais importante é experimentar na prática. Ao executar comandos e entender as mensagens de erro, você aprofundará gradualmente suas habilidades como desenvolvedor.

Esta é a conclusão do guia completo para usar o npm no Ubuntu. Esperamos que ele ajude você a criar um ambiente de desenvolvimento mais eficiente e poderoso.