Última atualização: 2026-06-29

Tamanho de clone git

O tamanho de um clone git é a soma de dois componentes: a árvore de trabalho, que contém os arquivos na revisão atual, e o packfile, que armazena o histórico completo de todas as alterações. Em repositórios ativos com muitos colaboradores e longa vida útil, o packfile pode facilmente superar a árvore de trabalho em tamanho.

O modelo de estimativa

A estimativa usa duas equações em sequência:

onde $W$ é o tamanho da árvore de trabalho, $N$ é o número de commits, $C$ é a alteração média de dados por commit antes da compressão, $r$ é a taxa de compressão do packfile (fração retida após a codificação delta e o zlib), $H$ é o tamanho estimado do histórico e $T$ é o tamanho estimado do clone completo.

Exemplo resolvido. Repositório com 100 MB de árvore de trabalho, 1.000 commits, 50 kB de delta médio e 30% de eficiência de compressão:

O histórico representa cerca de 12% do clone nesse cenário. Em repositórios mais antigos com histórico extenso, essa proporção pode ser muito maior.

O packfile e a codificação delta

O git armazena objetos em packfiles para economizar espaço. O mecanismo central é a codificação delta: em vez de guardar cada versão de um arquivo integralmente, o git armazena apenas as diferenças entre versões próximas. Essas diferenças são então comprimidas com zlib.

A taxa de compressão resultante varia conforme o tipo de conteúdo:

Uma taxa de 30% significa que apenas 30% do volume bruto de deltas permanece no packfile; 70% é eliminado pela compressão. Para arquivos binários incompressíveis, a taxa se aproxima de 100%.

Como medir os parâmetros reais

Para obter valores precisos do repositório, use os seguintes comandos:

• Tamanho da árvore de trabalho: git ls-files | xargs du -ch | tail -1 ou du -sh --exclude=.git .
• Número de commits: git rev-list --count HEAD
• Delta médio por commit: git log --shortstat --format="" | awk '/files? changed/ {sum+=$4+$6; n++} END {print sum/n " B"}'
• Tamanho real em disco: git count-objects -vH — o campo size-pack mostra o tamanho atual dos packfiles

O comando git count-objects -vH retorna o tamanho verdadeiro do banco de dados de objetos e serve como referência para validar a estimativa.

Por que o histórico cresce mais rápido que a árvore de trabalho

Cada commit adiciona um novo conjunto de deltas permanente ao histórico. Em um repositório ativo com 50 desenvolvedores fazendo commits diariamente, o histórico pode crescer dezenas de megabytes por mês, mesmo que o tamanho da árvore de trabalho permaneça estável. Ao longo de anos, o acúmulo se torna substancial.

O git gc e o git repack reorganizam os objetos existentes para melhorar a eficiência da compressão, mas não removem histórico — para isso é necessário reescrita de histórico com git filter-repo ou o uso de clones superficiais.

Estratégias para reduzir o tamanho do clone

Clone superficial. git clone --depth N baixa apenas os últimos N commits. Para integração contínua (CI), --depth 1 é comum e reduz o volume de download em 90% ou mais em repositórios antigos. O clone pode ser aprofundado depois com git fetch --unshallow.

Clone parcial (partial clone). git clone --filter=blob:none baixa a árvore de commits e de árvores, mas não os blobs (conteúdo de arquivo) antigos. Os blobs são baixados sob demanda conforme o acesso. Útil quando o histórico tem arquivos grandes que raramente são consultados.

Git LFS. Para repositórios com muitos ativos binários, o Git Large File Storage (Git LFS) armazena os binários em um servidor separado e mantém no repositório apenas ponteiros leves. Isso reduz consideravelmente o tamanho do packfile para repositórios de jogos, design e ciência de dados.

Limpeza de histórico. Se arquivos grandes foram acidentalmente adicionados e depois removidos, eles ainda existem no histórico. A ferramenta git filter-repo reescreve o histórico para eliminá-los permanentemente, reduzindo o tamanho do clone para todos os clones futuros.

Calculadoras relacionadas

Para estimar o tempo necessário para baixar o repositório, use a calculadora Calculadora de tempo de transferência de dados. Para entender como a compressão funciona em outros contextos, consulte a calculadora Calculadora de Taxa de Compressão.