Übersicht

git pack-refs [--all] [--no-prune]

Beschreibung

Der git pack-refs-Befehl konsolidiert viele einzelne Ref-Dateien (eine pro Branch/Tag in .git/refs/) in eine einzige .git/packed-refs-Datei. Das ist schneller auf Dateisystemen, in denen das Öffnen vieler kleiner Dateien langsam ist (älteres Windows, Netzwerk-Dateisysteme), und reduziert die Dateisystem-Last für Repos mit Tausenden von Refs.

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

Häufige Optionen

Option	Beschreibung
--all	Packt alle Refs (Standard packt nur Branches und Tags).
--no-prune	Entfernt einzelne Ref-Dateien nach dem Packen nicht.

Beispiele

git pack-refs --all
    # Jede Ref in packed-refs packen

    ls .git/refs/heads/ | wc -l
    # Nach dem Packen sind einzelne Dateien entfernt

    git pack-refs
    # Standard: Branches und Tags packen

Häufige Fehler

packed-refs von Hand zu bearbeiten kann das Repository korrumpieren — verwenden Sie git update-ref. Nach pack-refs schlagen Skripte fehl, die nach einzelnen Dateien in .git/refs/heads/ suchen. Verwenden Sie git for-each-ref für eine portable Suche.

Verwandte Befehle

git gc, git update-ref, git for-each-ref, git maintenance