O que o sparse checkout seleciona
Um clone esparso é um clone do Git configurado para manter apenas parte dos arquivos versionados no diretório de trabalho. O sparse checkout define essa seleção sem excluir os demais caminhos dos commits.
O diretório de trabalho é a pasta na qual você abre e edita o projeto. Uma busca limitada aos arquivos presentes pode deixar de encontrar código que continua registrado no repositório.
Selecionar a pasta do site
Neste exemplo, você trabalha num monorepo já clonado e quer abrir os arquivos do site que ficam em website. A seleção é feita na raiz do repositório:
git sparse-checkout set --cone websitegit sparse-checkout listO primeiro comando seleciona website e seu conteúdo, além dos arquivos diretamente na raiz que o modo cone também inclui. O segundo mostra website como diretório selecionado, sem listar cada arquivo presente.
Uma ferramenta que precisa de outra pasta pode falhar nessa configuração. Você pode ampliar a seleção com git sparse-checkout add, conforme a documentação do Git.
Download e histórico têm controles próprios
O sparse checkout não reduz por si só o histórico baixado. O git clone oferece --filter para clones parciais e --depth para limitar o histórico. Essas opções podem ser combinadas com a seleção de arquivos.
Dúvidas frequentes
Perguntas frequentes sobre clones esparsos
- O sparse checkout sempre reduz o download?
- A seleção controla os arquivos presentes no diretório de trabalho. Para reduzir a transferência inicial de objetos, você pode combiná-la com um clone parcial.
- Como consultar os diretórios selecionados?
- O comando git sparse-checkout list mostra a seleção configurada. No modo cone, ele lista os diretórios selecionados, mas os arquivos da raiz também são incluídos.
- Um clone esparso também é raso?
- São configurações independentes. A opção --depth limita o histórico do clone. O sparse checkout seleciona os caminhos presentes para edição.
Para continuar
Recursos relacionados
Documentação
Git: sparse checkout
Seleção de diretórios, comportamento do modo cone e comandos para consultar ou alterar o sparse checkout.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para investigar arquivos ausentes e ajustar o ambiente de desenvolvimento do seu repositório.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A seleção de arquivos altera o código disponível para os agentes e para as ferramentas usadas no desenvolvimento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.