O que é a área de staging no Git?

Question

Accepted Answer

A **área de staging** (também chamada de **index**) é uma área intermediária entre seu diretório de trabalho e o repositório — onde você **prepara** quais mudanças entram no próximo commit. Permite que você crie commits com precisão, selecionando exatamente o que incluir. ## As três áreas do Git ```text WORKING DIRECTORY → your actual files (where you edit) │ git add ▼ STAGING AREA (index) → changes PREPARED for the next commit (a staging zone) │ git commit ▼ REPOSITORY (.git) → committed snapshots (the permanent history) ``` As mudanças fluem assim: você edita arquivos (diretório de trabalho), `git add` coloca as mudanças selecionadas na staging area, e `git commit` registra as mudanças staged como um commit (repositório). ## Por que uma staging area? Criando commits precisos ```bash # edit 3 files, but commit them as TWO logical commits: git add file1.js file2.js # stage only these two git commit -m "Add feature X" # commit just those git add file3.js # stage the third git commit -m "Fix unrelated bug" # separate, logical commit # → the staging area lets you GROUP related changes into clean, focused commits ``` A área de staging permite que você **selecione exatamente quais mudanças** entram em cada commit — para que você possa fazer commits limpos, focados e lógicos (em vez de juntar todas as mudanças), até commitando diferentes partes do seu trabalho separadamente. ## Comandos úteis de staging ```bash git add # stage a file git add -p # stage SPECIFIC parts (hunks) of files interactively git reset # UNSTAGE a file (keep the changes) git status # see what's staged vs unstaged git diff # unstaged changes git diff --staged # staged changes (what WILL be committed) ``` `git add -p` é poderoso — permite que você coloque em staging **partes específicas** de um arquivo, para commits muito precisos. ## Por que isso importa Entender a área de staging é importante porque é uma parte distintiva e fundamental do modelo do Git, então compreendê-la é essencial para usar Git efetivamente. O conceito-chave — Git tem **três áreas** (diretório de trabalho onde você edita, staging area onde você prepara o próximo commit, e repositório onde os commits são armazenados) com mudanças fluindo entre elas via `add` e `commit` — é central para como Git funciona, e não entender a staging area leva a confusão sobre o fluxo de trabalho add/commit. O **propósito** da staging area é o que a torna valiosa: permite que você **crie commits precisos e focados** selecionando exatamente quais mudanças incluir — para que você possa agrupar mudanças relacionadas em commits limpos e lógicos (em vez de juntar todas as suas mudanças), até dividindo seu trabalho em múltiplos commits separados ou commitando apenas parte de um arquivo (com `git add -p` para colocar em staging partes específicas). Esta capacidade de criar **histórico de commits limpo e focado** é importante para manutenibilidade — commits bem organizados tornam o histórico legível, revisável e mais fácil de entender ou reverter. Entender os comandos de staging (`add`, `add -p`, `reset` para desstagetizar, e `diff --staged` para ver o que será commitado) é conhecimento prático do dia a dia. Como a staging area é uma parte fundamental e distintiva do fluxo de trabalho do Git (o passo intermediário entre editar e commitar) e entendê-la permite criar commits limpos e lógicos (uma marca de boa prática com Git), entender a staging area é conhecimento Git essencial, frequentemente aplicado — um conceito central que explica o modelo add/commit do Git e permite o histórico de commits focado e bem organizado que distingue o uso cuidadoso de Git, importante para todo desenvolvedor que trabalha com Git.