Instalando pacotes

Adicione o código de outras pessoas ao seu projeto

⏱ Estim. ~9 min

01 · Ler

Agora você vai instalar seu primeiro pacote npm: Express. O Express é o framework mais popular para web server em JavaScript. Mais de 30 milhões de engenheiros baixam ele por semana.

Quando você roda npm install, três coisas acontecem:

1. O npm baixa o pacote do registry 2. Ele salva o código em uma pasta chamada node_modules 3. Ele registra o nome do pacote em dependencies no seu package.json

Antes de continuar, confirme que você ainda está na pasta my-server.

02 · Prática real

Instale o Express. Isso vai baixar o Express e todos os pacotes que ele depende para o seu projeto. Rode o comando abaixo no terminal, espere terminar e clique em 'I did it' para continuar.

npm install express

03 · Prática real

Agora olhe o package.json de novo. Você deve ver uma seção dependencies nova listando o Express.

cat package.json

04 · Quiz

Qual arquivo rastreia as dependências do seu projeto para que outras pessoas possam instalá-las?

package.json
node_modules/index.js
dependencies.txt
.npmrc

05 · Prática real

Vamos dar uma espiada no node_modules — a pasta onde o npm guarda todos os pacotes baixados. O Express precisa de vários outros pacotes para funcionar, então você vai ver mais do que só 'express'.

ls node_modules | head -20

06 · Preencher

Para instalar o Express, digite npm _____ express.

07 · Ler

Quantas pastas! O Express depende de outros pacotes, e esses pacotes dependem de outros pacotes. Isso é a árvore de dependências (dependency tree).

Algo importante: você nunca deve fazer commit do node_modules no git. Ele pode ter milhares de arquivos e centenas de MB. O seu package.json registra o que você precisa, e qualquer um que clonar seu projeto pode rodar npm install para baixar tudo de novo.

É por isso que o package.json é tão importante — ele é a receita. O node_modules são os ingredientes.

💡 Imagine assimpackage.json é a lista de compras. node_modules são os ingredientes de verdade. Você compartilha a lista, não um caminhão de comida.

Pontos-chave

npm install baixa os pacotes para node_modules/
package.json registra de quais pacotes seu projeto depende
Nunca faça commit do node_modules no git — é muito grande
Qualquer um pode rodar npm install para recriar o node_modules

08 · Quiz

Um colega de equipe clona seu projeto do GitHub, sem a pasta node_modules. O que ele precisa rodar para pegar todas as dependências?

Ele precisa baixar cada pacote manualmente do npmjs.com
npm install — ele lê o package.json e baixa tudo
node install — o Node.js cuida do gerenciamento de dependências
Não dá — sem o node_modules original o projeto não funciona

Outras lições deste capítulo

⚠ A experiência interativa completa precisa de JavaScript. Ative-o e recarregue a página.

※ Este é um projeto educacional independente — não é um produto oficial da Anthropic. Claude™ é uma marca registrada da Anthropic, PBC.