Diretório de trabalho vs. área de preparo vs. repositório local: entendendo as três zonas locais do Git

By Mirko Peters · 2026-08-12

Domine as três zonas locais do Git: saiba como o diretório de trabalho, a área de preparo e o repositório local atuam juntos para dar a você controle preciso sobre o histórico do seu projeto.

Automatically translated with AI from the original post. Read the English original

Entender as três áreas locais do Git (o diretório de trabalho, a área de preparo e o repositório local) é essencial para sair da cópia caótica de arquivos e chegar a um controle de versão deliberado. Este guia explica como cada zona funciona como um escritório físico, para que você tenha controle preciso sobre o histórico do seu projeto.

Principais conclusões

• O diretório de trabalho é a pasta ativa do seu projeto, funcionando como uma mesa de escritório bagunçada, onde você edita arquivos livremente.
• A área de preparo funciona como uma bandeja de revisão, contendo apenas as alterações específicas que você seleciona com git add para o seu próximo checkpoint.
• O repositório local funciona como o arquivo de documentos, registrando de forma permanente as alterações preparadas como um histórico estruturado de commits.
• Os comandos git status e git diff funcionam como verificações de segurança, permitindo que você inspecione o que está acontecendo nas suas áreas locais antes de registrar o histórico.
• Entender essas três zonas evita commits acidentais e ajuda você a manter o histórico do projeto limpo e lógico.

O diretório de trabalho: sua mesa ativa

Quando você abre uma pasta de projeto no computador e começa a fazer edições, está operando diretamente na primeira zona local do Git: o diretório de trabalho. Pense nessa pasta como sua mesa física de trabalho. Ela contém todos os arquivos que você abre, cria, modifica ou exclui, incluindo código de sites, documentação, arquivos de configuração e imagens.

Assim como uma mesa real, o diretório de trabalho pode ficar bagunçado enquanto você experimenta. Você pode começar a reescrever um botão de login, notar um erro de digitação em um arquivo readme e criar um script experimental para testar um novo layout. O Git não força automaticamente cada modificação para o seu histórico permanente só por ter acontecido nessa pasta. Você tem liberdade para testar ideias, cometer erros e deixar trabalhos inacabados sem alterar permanentemente o registro do projeto.

Para ver o que mudou no diretório de trabalho desde o seu último checkpoint registrado, use o comando git status. Em termos simples, pedir ao Git o status é como fazer um inventário de tudo o que está sobre a sua mesa. Ele identifica arquivos modificados, novos e excluídos, mostrando exatamente o que mudou desde o seu último commit.

A área de preparo: a bandeja de revisão

A área de preparo talvez seja o conceito mais mal compreendido por desenvolvedores que estão começando com controle de versão, em grande parte porque o nome sugere um misterioso depósito técnico. Em vez disso, imagine a área de preparo como uma bandeja de revisão ao lado da sua mesa. Você coloca nela apenas as alterações destinadas ao seu próximo checkpoint.

Suponha que você passe a manhã corrigindo um link crítico de redefinição de senha e, ao mesmo tempo, começa um redesenho experimental da tela de boas-vindas. Você certamente quer registrar a correção da senha, mas o redesenho está incompleto e com bugs. Você não quer que as duas alterações sejam agrupadas no mesmo commit.

Ao executar git add seguido do arquivo de redefinição de senha, você coloca essa alteração específica e concluída na área de preparação (staging). Apesar do nome, git add não salva seu trabalho de forma permanente nem envia nada para um servidor online. Ele apenas prepara uma versão limpa e escolhida desse arquivo para o seu próximo ponto de controle. Essa pausa curta lhe dá um controle enorme. Você pode revisar as alterações preparadas, remover itens que adicionou antes da hora ou incluir arquivos adicionais que pertencem exatamente à mesma unidade lógica de trabalho.

O repositório local: o arquivo de documentos

Quando a bandeja de revisão contiver exatamente o conjunto de alterações que você quer preservar, essas edições passam para a terceira zona do Git: o repositório local. Se o diretório de trabalho é a sua mesa e a área de preparação é a sua bandeja de revisão, o repositório local é o seu arquivo de documentos seguro.

O repositório local armazena todos os seus commits e o histórico do projeto diretamente no seu computador, dentro de pastas ocultas do sistema. Quando você executa git commit -m "Fix password reset link", o Git pega as alterações preparadas na área de preparação e as registra em um ponto de controle permanente e nomeado.

Essa arquitetura local-first significa que você pode construir um histórico de projeto completo e rastreável sem conexão com a internet ou um serviço de hospedagem online. Tudo acontece com segurança no seu próprio hardware. Seu fluxo de trabalho diário se torna um ritmo confiável: você edita arquivos no diretório de trabalho, verifica a situação com git status, seleciona alterações específicas com git add e registra suas escolhas com git commit.

Conclusão

Dominar a distinção entre o diretório de trabalho, a área de preparação e o repositório local muda a forma como você aborda projetos de desenvolvimento. Ao tratar sua pasta como um espaço de trabalho, a área de preparação como uma bandeja de revisão e o repositório local como um arquivo de documentos permanente, você ganha controle total sobre o histórico do seu projeto.

Para se aprofundar nos fundamentos do controle de versão, ouça o episódio completo do M365 FM Podcast para ouvir Mirko Peters explicar o Git em linguagem simples e descobrir como essas mecânicas locais se encaixam em fluxos de trabalho de equipes mais amplos.

Perguntas frequentes

Qual é a diferença entre o diretório de trabalho e a área de preparação?

O diretório de trabalho é a pasta ativa do projeto, onde você edita, cria e exclui arquivos livremente. A área de preparação é uma bandeja de revisão seletiva, onde você coloca apenas as alterações específicas que pretende incluir no próximo commit.

O git add salva meus arquivos de forma permanente?

Não. O comando git add prepara seus arquivos ao movê-los para a área de preparação, mas não os registra de forma permanente no histórico do projeto nem os envia online. O registro permanente só acontece quando você executa git commit.

Posso usar o Git sem um serviço de hospedagem online?

Sim. O Git foi projetado para funcionar totalmente de forma local no seu computador. Você pode criar um repositório local, fazer commits, gerenciar branches e consultar o histórico sem nunca se conectar ao GitHub ou à internet.

O que devo fazer se preparar um arquivo por engano?

Se você preparar um arquivo cedo demais, o Git oferece comandos de remoção da preparação (como git reset) que retiram com segurança o arquivo da área de preparação e o devolvem ao diretório de trabalho, sem perder suas últimas edições.