git sparse-checkout

Arbeitsbereiche & große Projekte

Checkt nur einige Ordner eines großen Repositorys aus

Der Befehl 'git sparse-checkout' begrenzt, welche Ordner auf der Platte liegen. Dateien außerhalb dieser Ordner bleiben in jedem Commit und im Repository, sie werden nur nicht ausgecheckt — nützlich in riesigen Repositorys, in denen du nur an einem Teil arbeitest. Im Cone-Modus (Standard) sind Dateien der obersten Ebene immer vorhanden. git status sagt dir, wie viel Prozent der Dateien auf der Platte sind.

Syntax

git sparse-checkout (set | add) <folder>...
git sparse-checkout list
git sparse-checkout disable
[ ] optional| oder<arg> Platzhalter... wiederholbar--flag Option

Optionen

Klicke auf eine Option, um sie aufzuklappen

Einsteiger (4)

Wählt die Ordner, die auf der Platte bleiben (ersetzt die aktuelle Liste).

EmpfohlenDie Ordner wählen, in denen du arbeitest

Beispiel

git sparse-checkout set src

Fügt Ordner zu den behaltenen hinzu.

EmpfohlenDen Checkout erweitern, ohne neu anzufangen

Beispiel

git sparse-checkout add docs

Gibt die aktuell behaltenen Ordner aus.

EmpfohlenPrüfen, was auf der Platte liegt

Beispiel

git sparse-checkout list

Schaltet Sparse Checkout aus und stellt jede Datei wieder her.

EmpfohlenZu einem normalen Checkout zurückkehren

Beispiel

git sparse-checkout disable

Die richtige Option wählen

Mit einem riesigen Repository arbeiten

Weniger auf der Platte oder weniger heruntergeladen

BefehlSpart
git sparse-checkoutPlattenplatz und Checkout-Zeit
git clone --filter=blob:noneDownload-Größe (Partial Clone)
git clone --depth 1Größe der Historie (flacher Klon)

Beispiele

Einen Ordner behalten

git sparse-checkout set src

Nur src/ und die Dateien der obersten Ebene.

Einen Ordner hinzufügen

git sparse-checkout add docs

docs/ kommt auch zurück.

Ausschalten

git sparse-checkout disable

Wieder alle Dateien.

Workflow-Beispiele

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

Leicht klonen, von Anfang an sparse

2
git sparse-checkout set web

Nur deinen Ordner behalten

Fehlerbehebung

Ein Ordner fehlt

Ursache: Er liegt außerhalb des Sparse Checkouts

git sparse-checkout add <folder>

Tipps & Stolperfallen

Best Practices

  • ✓Nutze den Cone-Modus (Standard) — er ist viel schneller als Muster.

Häufige Fehler

  • ✗Glauben, die ausgeblendeten Dateien seien aus dem Projekt gelöscht — sie werden weiterhin normal committet und gepusht.

FAQ

A:

Du siehst sie nicht, also fasst du sie normalerweise nicht an; Commits behalten sie unverändert.