NPM para iniciantes: o que é e para que serve o package.json?

Dê os primeiros passos no desenvolvimento web moderno organizando suas dependências

Olá devs! 💜

Você está dando seus primeiros passos no desenvolvimento web com JavaScript e decide aprender a criar servidores com Node.js ou usar frameworks como React.

Você lê os tutoriais, digita comandos de terminal sugeridos como npm install e, de repente, uma pasta gigantesca chamada node_modules e dois arquivos estranhos chamados package.json e package-lock.json surgem na sua área de trabalho.

Entrar em contato com o ecossistema de dependências pela primeira vez costuma gerar muitas dúvidas:

“O que são esses arquivos, por que a pasta node_modules é tão pesada e como gerenciar tudo isso?”.

Compreender a lógica do NPM e do arquivo package.json é fundamental para tirar o melhor proveito do desenvolvimento moderno.

É exatamente isso que vamos ver no post dessa semana!

🥰 Siga nossa página no Linkedin e no Instagram e ajude a divulgar nosso conteúdo. Por mais mulheres em tech!

---

Veja também:

• Ambientes virtuais em Python: Um guia para iniciantes

• 8 mulheres de destaque na computação

• 16 tags de HTML que toda dev precisa saber

• Atalhos do VS Code que toda dev precisa saber

---

O que é o NPM e o package.json? (A analogia do livro de receitas e despensa)

Para entender como funciona o ecossistema de pacotes, vamos fazer uma analogia culinária de um restaurante profissional:

As Bibliotecas de Código (Ingredientes)

São ferramentas e trechos de código prontos criados por outras pessoas.

Ex: uma biblioteca para conectar ao banco ou para criar animações.

O NPM (Node Package Manager - O Fornecedor)

É um enorme mercado online com milhões de bibliotecas prontas.

Quando você digita npm install, você está pedindo para o fornecedor entregar os ingredientes na sua cozinha.

A pasta node_modules (A Despensa)

É a despensa física do seu projeto onde os ingredientes (bibliotecas) importados ficam guardados.

Por ter milhares de pastas internas de dependências, ela é extremamente pesada.

O arquivo package.json (O Livro de Receitas)

É a lista e o manual do seu projeto.

Em vez de guardar todas as sacolas de compras pesadas de ingredientes no GitHub, você envia apenas o livro de receitas.

Nele está escrito exatamente o nome e a marca (versão) de cada ingrediente necessário para o bolo dar certo.

Quando outra desenvolvedora baixa o seu livro de receitas (package.json), ela roda o comando npm install e o fornecedor (NPM) vai até a despensa dela (node_modules) e baixa exatamente os ingredientes necessários de forma automática.

---

Por dentro do arquivo package.json

O arquivo package.json é escrito em formato JSON (uma lista estruturada de chaves e valores) e contém as informações básicas do seu projeto:

{
  "name": "meu-primeiro-projeto",
  "version": "1.0.0",
  "description": "Um site simples usando Node.js",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "test": "jest"
  },
  "dependencies": {
    "express": "^4.19.2"
  },
  "devDependencies": {
    "jest": "^29.7.0"
  }
}

• scripts: Atalhos de comandos de terminal configurados para agilizar sua vida. Em vez de digitar um comando longo para iniciar o servidor, você roda apenas npm start.

• dependencies: As bibliotecas que seu projeto precisa para rodar em produção (como o Express para servidores ou React para interfaces).

• devDependencies: Ferramentas de desenvolvimento auxiliares usadas apenas na sua máquina de estudos (como o Jest para testes ou bibliotecas de formatação de código), que não vão para o servidor final.

---

Dicas de uso com pacotes NPM

NUNCA suba a pasta node_modules para o GitHub!

Como ela contém milhares de arquivos que podem ser baixados a qualquer momento pelo NPM, adicione node_modules dentro do seu .gitignore.

Como criar o arquivo

Para iniciar um novo projeto e criar o package.json automaticamente pelo terminal, digite:

npm init -y

Como instalar uma biblioteca:

• Como dependência de produção: npm install express

• Como dependência de desenvolvimento: npm install jest --save-dev

---

🎁 Receba nossos recursos gratuitos!

Ao assinar nossa newsletter gratuitamente, você terá acesso à nossa biblioteca de recursos, com guias rápidos, e-book, e outros materiais.

👉 https://mulheresprogramando.substack.com/subscribe

Após se inscrever, você receberá um e-mail de boas-vindas com o link para a página de recursos.

---

Por que isso é importante para a sua carreira?

Praticamente todo projeto de desenvolvimento web moderno (Front-end e Back-end JavaScript) utiliza o NPM ou gerenciadores equivalentes (como Yarn ou PNPM).

Compreender como estruturar o package.json de forma organizada, gerenciar versões de pacotes e utilizar atalhos na seção de scripts demonstra aos recrutadores que você tem intimidade com as ferramentas reais de engenharia usadas nas empresas.

Esse conhecimento te poupa de erros de deploy comuns de ambiente e prova que você já programa pensando em código colaborativo e profissional.

Espero que tenham gostado do post e até a próxima! 💕