powered byiMasterstutoriais · referência · código em portuguêsPatrocínio
Fundamentos

O modelo de dados do Git: como objetos, referências e índice se encaixam

Um documento de referência escrito por Julia Evans e publicado em janeiro de 2026 organiza os termos objeto, referência e índice que a documentação do Git sempre usou sem nunca explicar juntos.

Por Letícia AmaralColunista7 min de leitura
Imagem gerada por IA

Um documento de referência escrito por Julia Evans e publicado em janeiro de 2026 organiza os termos objeto, referência e índice que a documentação do Git sempre usou sem nunca explicar juntos.

Ao final deste texto, você vai conseguir nomear cada peça que compõe um repositório Git (objeto, referência, índice e árvore de trabalho), inspecionar objetos crus com git cat-file e entender por que o índice guarda até três versões de um arquivo durante um conflito de merge. Os comandos abaixo valem para qualquer instalação do Git 2.x atual, sem recurso experimental envolvido.

O que motivou a reforma na documentação

No outono do hemisfério norte de 2025, a programadora Julia Evans, conhecida por seus zines sobre ferramentas de linha de comando, trabalhou ao lado de uma colaboradora identificada no post apenas como Marie para revisar partes da documentação oficial do Git. O resultado, publicado no blog pessoal de Evans em 8 de janeiro de 2026, foi um documento novo chamado "data model" (modelo de dados) e a atualização de quatro páginas de manual que praticamente todo usuário de Git já abriu: git-add, git-checkout, git-push e git-pull.

O ponto de partida foi simples de enunciar e difícil de resolver: a documentação do Git usa os termos "object", "reference" e "index" o tempo todo, mas nunca parou, num único lugar, para explicar o que cada um significa e como eles se relacionam com conceitos do dia a dia como commit e branch. Em janeiro de 2026, segundo Evans, o documento ainda não estava publicado no site oficial git-scm.com; a expectativa dela era de que ele entrasse numa release futura do projeto.

Objeto, referência e índice, lado a lado

Esse é o núcleo que faltava numa página só. A tabela abaixo resume o que cada termo cobre e onde ele mora dentro da pasta .git.

TermoO que éOnde moraComando pra inspecionar
Objeto (object)Unidade imutável de dado, endereçada pelo hash do próprio conteúdo.git/objects/git cat-file -p <hash>
Referência (reference)Ponteiro nomeado para um objeto, geralmente um commit.git/refs/ e .git/HEADgit show-ref, git symbolic-ref HEAD
Índice (index / staging area)Lista do que vai entrar no próximo commit, guardada fora do histórico.git/indexgit ls-files -s
Árvore de trabalho (working tree)Os arquivos reais que você edita no discodiretório do projetogit status

Um branch, nessa descrição, não é uma estrutura especial: é só uma referência que mora em .git/refs/heads/ e que o Git atualiza automaticamente a cada novo commit. HEAD, por sua vez, costuma ser uma referência para uma referência (aponta para o branch atual, que aponta para o commit).

Os quatro tipos de objeto por baixo do capô

Dentro da categoria "objeto" existem quatro tipos concretos, e cada um aponta para o seguinte numa cadeia:

TipoGuardaAponta para
blobo conteúdo bruto de um arquivonada, é folha
treeum "diretório": nomes de arquivo e os hashes dos blobs e trees dentro deleblobs e outras trees
commitmetadados (autor, data, mensagem) mais o hash de uma tree e o hash do(s) commit(s) pai(s)uma tree e zero, um ou mais commits
tagum nome fixo apontando pra outro objeto, geralmente um commit, com assinatura opcionalqualquer objeto

Dá pra ver essa cadeia funcionando num repositório qualquer:

bash
git init demo && cd demo
echo "primeira linha" > arquivo.txt
git add arquivo.txt
git commit -m "primeiro commit"

git cat-file -t HEAD        # imprime: commit
git cat-file -p HEAD        # mostra o hash da tree, autor, committer e mensagem
git cat-file -p HEAD^{tree} # lista modo, tipo, hash do blob e nome do arquivo

É esse encadeamento (commit aponta para tree, tree aponta para blob) que o documento novo de Evans resume em cerca de 1600 palavras.

Onde o índice guarda o conflito de merge

Aqui está o detalhe que a própria Evans diz ter precisado revisar durante o processo de escrita: como o índice se comporta num merge com conflito. Em condições normais, o index tem uma entrada por arquivo, chamada stage 0. Durante um merge conflituoso, o Git substitui essa entrada única por até três, uma para cada lado do conflito:

bash
git ls-files -u
# 100644 <hash-base>    1   arquivo.txt
# 100644 <hash-ours>    2   arquivo.txt
# 100644 <hash-theirs>  3   arquivo.txt

A stage 1 é o ancestral comum, a stage 2 é a versão do branch em que você está (ours) e a stage 3 é a versão que está sendo incorporada (theirs). É por isso que git add arquivo.txt, depois de resolver o conflito manualmente, "funciona": ele colapsa as três entradas de volta para uma única stage 0, e é esse colapso que o Git usa como sinal de que o conflito foi marcado como resolvido.

As quatro man pages que mudaram

As páginas revisadas foram git-add, git-checkout, git-push e git-pull. As duas últimas, segundo Evans, exigiram mais trabalho: além de reescrever a introdução, a dupla adicionou uma seção explicando o que é um "upstream branch" (termo que a documentação usava sem nunca definir) e uma descrição mais direta do que é um "push refspec".

Nem toda frase saiu perfeita. Evans admite que um trecho ficou intencionalmente vago, porque explicar com exatidão todas as combinações da configuração push.default exigiria um projeto à parte:

git push pode falhar se você não tiver configurado um upstream para o branch atual, dependendo do valor de push.default.

git push may fail if you haven't set an upstream for the current branch, depending on what push.default is set to.Documentação oficial do Git, man page de git-push

Como a revisão foi testada: 80 leitores no Mastodon

Em vez de discutir clareza com outros desenvolvedores experientes, Evans pediu no Mastodon que leitores comentassem a versão em rascunho das páginas e apontassem o que achavam confuso. Cerca de 80 pessoas responderam, a maioria com cinco a dez anos de uso regular de Git. O retorno incluiu termos sem definição (o que é um pathspec? "upstream" tem um sentido técnico específico?), frases confusas, sugestões de conteúdo faltante e inconsistências entre páginas diferentes do próprio manual.

Evans resume por que preferiu esse método a uma discussão entre especialistas:

Usuários especialistas de um software são surpreendentemente ruins para avaliar se uma explicação vai ficar clara para quem não é especialista.

Expert users of a piece of software are notoriously bad at being able to tell if an explanation will be clear to non-experts.Julia Evans, desenvolvedora e autora do blog jvns.ca

O caminho até o código aceito

Contribuir com o Git tem um processo próprio, que Evans descreve rapidamente sem se aprofundar. O projeto mantém um servidor no Discord com um canal de "primeira contribuição" para quem está começando. Para enviar as mudanças, ela usou o GitGitGadget: a ferramenta converte um pull request comum do GitHub no formato que os mantenedores do Git usam de fato, patches por e-mail trocados numa lista de discussão.

O arquivo dessa lista fica em lore.kernel.org, e Evans achou a navegação difícil o bastante para montar seu próprio visualizador das threads. O crédito pela revisão técnica, segundo o post, foi dividido entre Emily Shaffer, Johannes Schindelin (autor do GitGitGadget), Patrick Steinhardt, Ben Knoble e Junio Hamano, mantenedor do projeto.

Para continuar a referência

O documento "data model" ainda não tinha, em janeiro de 2026, uma URL fixa no site oficial git-scm.com; ele estava disponível como parte da mudança em revisão, com expectativa de entrar numa release futura do Git. Até lá, a fonte mais confiável sobre a versão instalada na sua máquina continua sendo o próprio manual local: git help <comando> ou man git-push sempre refletem a versão exata do binário que você está rodando.

Como exercício, vale pegar um repositório qualquer, achar o hash de HEAD com git rev-parse HEAD e, só com git cat-file -p, subir manualmente a cadeia até chegar num blob: commit aponta pra tree, tree aponta pra blob. Quando esse caminho ficar automático na sua cabeça, as próximas paradas naturais são a documentação de git-rebase (que reescreve a cadeia de commits) e a de git-reflog (que guarda o histórico de pra onde cada referência já apontou).

Fonte: Julia Evans

PatrocínioContinue estudando FundamentosTrilhas completas, projetos e exercícios na DevMedia.Travou em algum passo?Pergunte no Fórum iMastersPoste o trecho de código e o erro: a comunidade responde.Notícias da stackO que saiu de novo, no iMastersLançamentos, versões e eventos do ecossistema dev.

Este artigo foi escrito por Letícia Amaral. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Letícia Amaral

Editora virtual de Fundamentos do Linha de Código. Explica o conceito uma vez e mostra em mais de uma linguagem: lógica, algoritmos, estruturas de dados, orientação a objetos, Git, testes, HTTP e arquitetura. É a porta de entrada de quem está aprendendo a programar e a referência de quem precisa lembrar como se resolve.

Mais de Letícia Amaral

Newsletter

Os melhores tutoriais da semana, no seu e-mail

Toda semana, os tutoriais novos das sete stacks e o guia de referência que vale guardar. Gratuita, sem spam.