git sparse-checkout

Espaços de trabalho e projetos grandes

Faz checkout só de algumas pastas de um repositório grande

O comando 'git sparse-checkout' limita quais pastas ficam no disco. Os arquivos fora dessas pastas continuam em cada commit e no repositório, só não são colocados no disco — útil em repositórios enormes onde você só trabalha numa parte. No modo cone (padrão), os arquivos da raiz sempre estão presentes. O git status diz qual porcentagem dos arquivos está no disco.

Sinopse

git sparse-checkout (set | add) <folder>...
git sparse-checkout list
git sparse-checkout disable
[ ] opcional| ou<arg> valor a substituir... repetível--flag opção

Opções

Clique em uma opção para expandir

Iniciante (4)

Escolhe as pastas a manter no disco (substitui a lista atual).

RecomendadoEscolher as pastas em que você trabalha

Exemplo

git sparse-checkout set src

Adiciona pastas às que você mantém.

RecomendadoAmpliar o checkout sem recomeçar

Exemplo

git sparse-checkout add docs

Imprime as pastas mantidas.

RecomendadoConferir o que está no disco

Exemplo

git sparse-checkout list

Desliga o sparse checkout e restaura todos os arquivos.

RecomendadoVoltar a um checkout normal

Exemplo

git sparse-checkout disable

Escolhendo a opção certa

Trabalhar com um repositório enorme

Menos no disco versus menos baixado

ComandoEconomiza
git sparse-checkoutEspaço em disco e tempo de checkout
git clone --filter=blob:noneTamanho do download (clone parcial)
git clone --depth 1Tamanho do histórico (clone raso)

Exemplos

Manter uma pasta

git sparse-checkout set src

Só src/ e os arquivos da raiz.

Adicionar uma pasta

git sparse-checkout add docs

docs/ volta também.

Desligá-lo

git sparse-checkout disable

Todos os arquivos de novo.

Exemplos de fluxos de trabalho

1
git clone --filter=blob:none --sparse <url>

Clonar leve, sparse desde o início

2
git sparse-checkout set web

Manter só a sua pasta

Solução de problemas

Falta uma pasta

Causa: Ela está fora do sparse checkout

git sparse-checkout add <folder>

Dicas e armadilhas

Boas práticas

  • ✓Use o modo cone (padrão) — é muito mais rápido que padrões.

Erros comuns

  • ✗Achar que os arquivos ocultos são apagados do projeto — continuam sendo commitados e enviados normalmente.

Perguntas frequentes

A:

Você não os vê, então normalmente não mexe neles; os commits os mantêm inalterados.