Übersicht

git cat-file (-t | -s | -p | -e) <object>
git cat-file --batch
git cat-file --batch-check

Beschreibung

Der git cat-file-Befehl ist ein Plumbing-Tool, das rohe Git-Objekte aus der Objektdatenbank liest. Er kann Typ (blob, tree, commit, tag), Größe und Inhalt eines Objekts ausgeben. Der --batch-Modus erlaubt es Skripten, viele Objektnamen über stdin zu übergeben und strukturierte Ausgabe zu erhalten, was weit schneller ist, als cat-file pro Objekt aufzurufen.

Im täglichen Einsatz integriert sich git cat-file 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 cat-file --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 cat-file 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 cat-file hilft, alle drei zu vermeiden.

Häufige Optionen

Option	Beschreibung
-t	Gibt den Objekttyp aus.
-s	Gibt die Objektgröße in Bytes aus.
-p	Gibt Inhalt typabhängig schön formatiert aus.
-e	Beendet sich mit Null-Status, falls das Objekt existiert.
--batch	Streamt <sha> <type> <size> CRLF <content> für jede Eingabe.
--batch-check	Wie batch, aber nur Header-Zeilen.
--filters	Wendet Smudge-Filter beim Ausgeben von Blobs an.

Beispiele

git cat-file -t HEAD
    # commit

    git cat-file -p HEAD
    # Commit-Nachricht und Tree-/Eltern-SHAs anzeigen

    git cat-file -p HEAD:src/main.c
    # Die Datei ausgeben, wie sie bei HEAD war

    echo HEAD | git cat-file --batch-check
    # Typ/Größe/SHA in maschinenlesbarer Form erhalten

Häufige Fehler

Eine partielle SHA zu übergeben, die mehrdeutig ist, gibt einen Fehler zurück — präzisieren Sie mit mehr Zeichen. -p zu vergessen und -t zu verwenden gibt keinen Inhalt aus. Der --batch-Modus erfordert sorgfältige Protokoll-Behandlung; respektieren Sie den Größen-Header, um die richtige Anzahl Bytes zu lesen.

Verwandte Befehle

git show, git hash-object, git ls-tree, git rev-parse