Übersicht

git ls-tree [-r] [-d] [-l] [--name-only] <tree-ish> [<path>...]

Beschreibung

Der git ls-tree-Befehl listet Einträge (Modus, Typ, SHA, Name) eines Tree-Objekts auf. Mit -r rekurriert er in Unterverzeichnisse. Es ist das Plumbing-Äquivalent von ls auf einem Git-Tree. Die Ausgabe ist ein Eintrag pro Zeile, geeignet zum Pipen in andere Tools.

Im täglichen Einsatz integriert sich git ls-tree eng mit Shell-Aliasen, Editor-Plugins und Continuous Integration. Power-User fügen oft Aliase hinzu, die Flags kombinieren, die sie immer übergeben, oder wickeln den Befehl in Skripte, die Teamkonventionen durchsetzen. Die Ausgabeformatierung kann über Git-Config angepasst werden — Pretty-Formate, Farbschemata und Pager-Verhalten sind alle einstellbar. Wenn etwas schiefgeht, ist der erste Diagnoseschritt üblicherweise, den Befehl erneut mit GIT_TRACE=1 in der Umgebung auszuführen, was die zugrunde liegenden Plumbing-Aufrufe offenlegt. Für ungewöhnliche Situationen öffnet die --help-Ausgabe (git ls-tree --help) die vollständige Manpage mit Details zu jeder Option, einschließlich solcher, die in alltäglichen Workflows selten verwendet werden, aber für Debugging oder Skripting im großen Maßstab essentiell sind.

Zu verstehen, wie git ls-tree mit dem Rest von Gits Datenmodell interagiert — der Objektdatenbank, dem Index, Refs und dem Working Tree — zahlt sich aus. Jeder Befehl operiert auf einer Teilmenge dieser Stücke, und zu wissen, welche er berührt, hilft Ergebnisse vorherzusagen und sich von Fehlern zu erholen. Das Lesen der offiziellen Git-Dokumentation neben praktischer Übung in einem Wegwerf-Repository ist der schnellste Weg, die Nuancen zu verinnerlichen. Die meisten Produktionsprobleme mit Git rühren von einer von drei Ursachen: überraschendem Standardverhalten, partiellen Netzwerkoperationen oder dem Umschreiben bereits geteilter Historie. Ein funktionierendes mentales Modell der Nebenwirkungen von git ls-tree hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
-r	Rekurriert in Subtrees.
-d	Zeigt nur Verzeichnisse (Trees).
-l	Bezieht die Größe von Blob-Einträgen ein.
--name-only	Zeigt nur Dateinamen.
-z	NUL-terminierte Ausgabe für sicheres Parsen.
--full-tree	Beschränkt nicht durch das aktuelle Verzeichnis.

Beispiele

git ls-tree HEAD
    # Top-Level-Einträge des HEAD-Trees

    git ls-tree -r HEAD --name-only
    # Alle Dateipfade bei HEAD

    git ls-tree -r -l v1.0 src/
    # Größen und SHAs für jede Datei unter src/ bei v1.0

    git ls-tree HEAD -- 'docs/*.md'
    # Nur Markdown-Dateien in docs/

Häufige Fehler

Working-Directory-relative gegenüber Repo-Root-relative Pfade verwechseln. Verwenden Sie --full-tree für eindeutige root-relative Ausgabe. Ohne -r wird nur eine Ebene gezeigt — leicht, verschachtelte Dateien zu übersehen.

Verwandte Befehle

git ls-files, git show, git cat-file, git diff-tree