Übersicht

git rev-parse [<options>] <arg>...

Beschreibung

Der git rev-parse-Befehl löst Git-Referenzen und Argumente auf. Er wandelt symbolische Namen (Branches, Tags, HEAD~3, HEAD@{yesterday}) in 40-stellige SHAs um, normalisiert Optionen und beantwortet Introspektions-Fragen zum aktuellen Repository (Top-Level-Pfad, Git-Verzeichnis, ob wir in einem Worktree sind). Es ist das Schweizer Taschenmesser des Git-Skriptings.

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

Häufige Optionen

Option	Beschreibung
--abbrev-ref	Gibt Kurz-Ref-Name aus (z. B. main, nicht refs/heads/main).
--short	Gibt abgekürzten SHA aus.
--show-toplevel	Gibt absoluten Pfad der Repo-Wurzel aus.
--git-dir	Gibt absoluten Pfad von .git aus.
--is-inside-work-tree	Ja/nein-Antwort, skript-freundlich.
--verify	Validiert, dass das Argument eine echte Ref ist.
--quiet	Unterdrückt Fehlerausgabe.

Beispiele

git rev-parse HEAD
    # Voller SHA des aktuellen Commits

    git rev-parse --abbrev-ref HEAD
    # Aktueller Branch-Name (oder "HEAD" falls detached)

    git rev-parse --show-toplevel
    # Pfad zur Repo-Wurzel, nützlich in Skripten

    git rev-parse --verify origin/main >/dev/null && echo OK
    # Testen, ob eine Ref existiert

Häufige Fehler

git rev-parse auf Benutzereingabe ohne --verify zu verwenden kann bei mehrdeutigen Argumenten erfolgreich sein und überraschende Ergebnisse erzeugen. In Subshells ist --show-toplevel ein verlässlicherer Anker als $PWD.

Verwandte Befehle

git symbolic-ref, git rev-list, git for-each-ref, git config