~/VibeHandbook
PDF grátis

Capítulo 01 · 02

Repositórios, commits e histórico

Três palavras que você vai ouvir o tempo todo. Vamos desmistificá-las.

Um repositório (ou "repo") é apenas uma pasta que o está observando. Você transforma uma pasta comum em um repo uma vez, e a partir daí o Git rastreia tudo dentro dela.

Um é um ponto de salvamento. É um instantâneo de todos os arquivos em um determinado momento, mais uma mensagem curta sua descrevendo o que mudou ("adicionei a página de login", "corrigi o botão de cadastro quebrado"). Você faz commits o tempo todo — pense em cada um como um checkpoint para o qual você pode querer voltar.

O histórico é a lista ordenada de todos os seus commits. É a linha do tempo. Você pode percorrê-la, ler o que cada mudança foi, e viajar de volta para qualquer ponto.

Veja como isso funciona na prática. Não se preocupe em decorar — na maior parte do tempo você vai deixar a IA rodar esses comandos para você — mas acompanhe a leitura para que as palavras deixem de ser um mistério:

# Turn the current folder into a Git repository (do this once)
git init

# See which files have changed since your last save point
git status

# Stage your changes, then save them as a commit with a message
git add .
git commit -m "Add the homepage layout"

# Look at your history — every commit, newest first
git log --oneline

git add . é você dizendo "inclua todas as minhas mudanças no próximo ponto de salvamento." git commit é o salvamento em si. O -m "..." é o seu bilhete para o seu eu do futuro. Escreva notas que você entenderia um mês depois.

Esses dois comandos movem seu trabalho por três estágios. Um arquivo que você edita não está salvo até ter percorrido todo o caminho até a direita:

   ┌─────────────────┐  git add   ┌─────────────────┐  git commit  ┌─────────────────┐
   │  WORKING DIR    │ ─────────▶ │     STAGING     │ ───────────▶ │     HISTORY     │
   │  files you edit │            │  changes picked │              │  saved commits  │
   │  (not saved yet)│            │  for next save  │              │  (safe forever) │
   └─────────────────┘            └─────────────────┘              └─────────────────┘
       you change             you choose what               it becomes a
        a file                goes in the commit            permanent snapshot

Quer offline?

Baixe o livro inteiro em PDF ou EPUB — grátis.