Como habilitar e utilizar o npm (Gerenciador de Pacotes do Node.js) no ServBay
O npm (Node Package Manager) é a ferramenta oficial de gerenciamento de pacotes do Node.js e um dos maiores repositórios de software open-source do mundo. Para desenvolvedores Node.js, o npm é fundamental, pois facilita a instalação, o compartilhamento e o gerenciamento das dependências de projetos. Com o ambiente integrado oferecido pelo ServBay, você pode começar a usar o npm para desenvolvimento de forma rápida e eficiente.
Pré-requisitos
Antes de utilizar o npm, é necessário instalar o Node.js no ServBay.
- Abra o aplicativo ServBay.
- Navegue até o painel Pacotes (Packages).
- Localize o pacote do Node.js e certifique-se de que está instalado e em execução.
O ServBay configura automaticamente o ambiente Node.js, incluindo o npm.
Verificando se o npm está instalado e disponível
O Node.js instalado via ServBay já inclui o npm, que fica habilitado por padrão. Você pode verificar rapidamente se o npm está instalado corretamente e acessível via terminal.
Abra seu aplicativo de terminal (como o Terminal do macOS).
Digite o comando abaixo para verificar a versão do
npm:bashnpm -v1Se o comando for executado com sucesso e exibir o número da versão (por exemplo,
10.2.0ou superior), significa que onpmestá instalado corretamente e pronto para ser usado no ambiente atual.bash# Exemplo de saída 10.2.01
2Caso veja um erro como "command not found: npm", confirme se você já instalou o pacote Node.js pelo ServBay e se as variáveis de ambiente do ServBay foram carregadas corretamente (normalmente, reiniciar o terminal ou o computador resolve esse tipo de questão).
Atualizando o npm
Embora o Node.js instalado pelo ServBay já venha com uma versão estável do npm, o npm é atualizado frequentemente de forma independente do Node.js. Para ter acesso aos recursos mais recentes e correções, você pode atualizar o npm assim:
npm install -g npm@latestEsse comando instala a versão mais recente do npm globalmente. O parâmetro -g garante a instalação global, permitindo o uso do novo comando npm em qualquer lugar do sistema.
Após a atualização, verifique a versão novamente usando:
npm -vPrincipais funcionalidades e usos comuns do npm
O poder do npm está em seu vasto ecossistema open-source e na facilidade de gerenciamento de dependências. Veja alguns cenários e comandos comuns do npm para o desenvolvimento diário:
Inicializando um novo projeto Node.js
Ao iniciar um novo projeto Node.js em um diretório vazio, utilize o comando npm init para criar o arquivo package.json, que centraliza os metadados do projeto, dependências e scripts executáveis.
cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init2
O npm init irá guiá-lo para inserir informações como nome do projeto, versão, descrição, arquivo de entrada etc. Se preferir, use npm init -y para gerar um package.json padrão de forma automática.
Instalando dependências do projeto
No diretório raiz do projeto (onde está o package.json), use o comando npm install para instalar todas as dependências listadas.
cd /Applications/ServBay/www/my-project.servbay.demo
npm install2
Esse comando lê os campos dependencies e devDependencies do package.json e instala os módulos necessários na pasta node_modules do projeto.
Adicionando novos pacotes de dependência
Se você precisar incluir uma nova biblioteca ou framework no projeto, utilize:
# Instalar uma dependência de runtime, como o framework Express
npm install express
# Instalar uma dependência de desenvolvimento, como o Mocha para testes
npm install mocha --save-dev2
3
4
5
Por padrão, npm install <nome-do-pacote> adiciona o pacote na pasta node_modules do projeto e atualiza automaticamente o campo dependencies do package.json. Ao utilizar o parâmetro --save-dev, o pacote vai para o campo devDependencies — ideal para ferramentas de desenvolvimento, testes ou build.
Removendo pacotes de dependência
Para remover uma dependência que não é mais necessária, use:
npm uninstall expressO pacote será removido de node_modules e o package.json será atualizado.
Atualizando as dependências do projeto
Para garantir que você está usando as versões mais recentes (compatíveis com o que está especificado no package.json), execute:
npm updateEste comando atualiza os pacotes instalados para as versões mais recentes permitidas pelas restrições no package.json.
Utilizando scripts npm
O campo scripts do arquivo package.json permite definir comandos customizados para automação de tarefas repetitivas, como rodar servidores de desenvolvimento, executar testes e fazer builds.
Por exemplo, você pode configurar os seguintes scripts em seu package.json:
{
"name": "my-project",
"version": "1.0.0",
"scripts": {
"start": "node index.js",
"test": "mocha test/**/*.js",
"build": "webpack --config webpack.config.js"
},
"dependencies": {
"express": "^4.18.2"
},
"devDependencies": {
"mocha": "^10.2.0",
"webpack": "^5.89.0"
}
}2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Depois, pode executá-los pelo terminal:
# Iniciar a aplicação
npm start
# Executar os testes
npm test
# Realizar o build do projeto
npm run build2
3
4
5
6
7
8
Observação: para scripts chamados start, test, install, restart, stop e alguns outros específicos, você pode omitir o run e apenas usar, por exemplo, npm start ou npm test.
Referência rápida de comandos npm úteis
Além dos usos principais apresentados, o npm possui outros comandos frequentes:
Instalar pacotes globalmente: recomendado para ferramentas de linha de comando usadas em todo o sistema.
bashnpm install -g <nome-do-pacote> # Exemplo: instalar o npx, para execução de comandos temporários (normalmente já incluso com o Node.js moderno) npm install -g npx # Exemplo: instalar o nodemon para reiniciar aplicações automaticamente durante o desenvolvimento npm install -g nodemon1
2
3
4
5Executar comandos temporários (npx): O
npx(incluído no npm a partir da versão 5.2) executa arquivos emnode_modules/.binou baixa e executa pacotes temporariamente, sem instalação global.bash# Criar um novo app React sem precisar instalar globalmente o create-react-app npx create-react-app my-react-app1
2Listar pacotes instalados globalmente: Exibe todos os pacotes globais e suas versões.
bashnpm list -g --depth=01Limpar o cache do npm: Em caso de erros de instalação por cache corrompido, limpe o cache para ajudar a resolver.
bashnpm cache clean --force1Visualizar informações de pacotes: Veja detalhes sobre determinada biblioteca, versão, dependências e mais.
bashnpm view <nome-do-pacote>1Pesquisar pacotes: Busque por pacotes diretamente do repositório npm.
bashnpm search <palavra-chave>1
Solução de problemas
npm command not found: Confirme que o pacote Node.js foi instalado pelo ServBay e que sua sessão de terminal pode acessar os caminhos de instalação do Node.js e npm. Reiniciar o terminal ou o computador costuma resolver problemas de path.- Falha ao instalar dependências: Verifique sua conexão de rede. Configurações de proxy em empresas podem impedir o funcionamento do npm; talvez seja preciso configurar o proxy no npm. Tente também limpar o cache (
npm cache clean --force) e repetir o processo. - Problemas de permissão: No macOS, a instalação global (
npm install -g) pode gerar erros de permissão. Recomenda-se usar o Node Version Manager (nvm) ou garantir que o ServBay esteja corretamente configurado, evitando o uso dosudopara instalar pacotes globalmente — isso pode causar problemas ainda maiores. O Node.js instalado pelo ServBay geralmente resolve permissões, permitindo uso sem privilégios elevados dentro do diretório do ServBay.
Conclusão
Com o ServBay, você conta com um ambiente Node.js completo para desenvolvimento local, podendo gerenciar pacotes e construir projetos facilmente com o poder do npm. Dominar os comandos e práticas do npm elevará sua produtividade e, conforme você se aprofunda no ecossistema Node.js, o npm se tornará um parceiro indispensável na sua jornada de desenvolvimento.