Criando um projeto
Configure um projeto Node.js de verdade do zero
⏱ Estim. ~9 min
01 · Ler
Todo software que você já usou — de app de celular a site gigante — começou assim: alguém criou uma pasta vazia e configurou um projeto dentro. Você vai fazer isso agora.
Configurar bem o projeto desde o começo economiza muita dor de cabeça depois. Um projeto no Node.js não é nada especial — é só uma pasta com um arquivo de configuração package.json que rastreia o nome, a versão e as dependências do seu projeto. Sem esse arquivo, ferramentas como o npm não sabem o que o seu projeto precisa nem como rodar.
Pensa como mudar para um apartamento novo. Antes de decorar ou convidar amigos, você precisa assinar o contrato e pegar as chaves. O npm init é a assinatura do contrato — ele cria o documento oficial (package.json) que diz 'esta pasta é um projeto de verdade'.
💡 Imagine assimComeçar um projeto é como mudar para um apartamento novo. Antes de decorar ou construir qualquer coisa, você assina o contrato (npm init) e recebe o documento oficial (package.json) que torna tudo válido.
Pontos-chave
- Todo projeto Node.js começa com uma pasta e um package.json
- O package.json rastreia a identidade e as dependências do projeto
- Configurar certo desde o começo evita bagunça quando o projeto cresce
02 · Prática real
Todo projeto começa com uma pasta. Crie uma chamada my-server e entre nela. Esses dois comandos criam o diretório e mudam para dentro dele.
mkdir my-server && cd my-server
03 · Prática real
Agora inicialize seu projeto com o npm. A flag -y significa 'usar todos os defaults' — pula as perguntas e cria o arquivo de configuração direto.
npm init -y
04 · Quiz
O que a flag -y em npm init -y faz?
- Instala a versão mais recente do npm
- Cria um arquivo yarn.lock
- Pula todas as perguntas e usa os defaults
- Yes, apaga os arquivos existentes
05 · Prática real
Vamos ver o que o npm criou. O package.json é o coração de todo projeto Node.js — ele descreve o seu projeto e rastreia as dependências.
cat package.json
06 · Preencher
O arquivo que rastreia as dependências do seu projeto se chama _____.
07 · Ler
O que cada campo do package.json significa: - name — o nome do seu projeto (default é o nome da pasta) - version — número da versão do projeto (começa em 1.0.0) - description — uma descrição curta do que o projeto faz - main — arquivo de entrada (qual arquivo roda quando alguém importa seu projeto) - scripts — comandos customizados que você pode rodar com npm run <name> - keywords — tags para busca quando você publica no npm - license — como outras pessoas podem usar seu código
O campo mais importante que você vai usar daqui a pouco é dependencies — ele lista cada pacote que o seu projeto precisa. No momento está vazio porque a gente ainda não instalou nada.
Pontos-chave
- package.json é o arquivo de configuração de todo projeto Node.js
- npm init -y cria ele com defaults razoáveis
- O campo dependencies rastreia quais pacotes o seu projeto usa
08 · Quiz
Você tenta rodar npm install express mas dá erro dizendo que não tem package.json. O que você precisa fazer primeiro?
- Instalar o Node.js de novo
- Criar um arquivo chamado express.js manualmente
- Rodar node install express em vez disso
- Rodar npm init -y para criar o arquivo package.json
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.