Übersicht

git update-index [--add] [--remove] [--refresh] [--assume-unchanged] <file>...

Beschreibung

Der git update-index-Befehl ist das Plumbing hinter git add. Er zeichnet Dateiinhalte im Index per SHA auf, verwaltet Flags wie assume-unchanged und skip-worktree und aktualisiert Index-Zeitstempel. Die meisten Porcelain-Operationen rufen ihn auf.

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

Häufige Optionen

Option	Beschreibung
--add	Fügt Dateien hinzu, die noch nicht im Index sind.
--remove	Entfernt Dateien aus dem Index.
--refresh	Frischt Stat-Info ohne Änderung des Inhalts auf.
--assume-unchanged	Sagt Git, diese Datei nicht auf Änderungen zu prüfen.
--no-assume-unchanged	Kehrt das Flag um.
--skip-worktree	Lässt Git Working-Tree-Änderungen ignorieren.
--chmod=(+|-)x	Ändert Executable-Bit.
--cacheinfo <mode> <sha> <path>	Fügt einen Eintrag manuell in den Index ein.

Beispiele

git update-index --assume-unchanged config/local.yml
    # Tracking lokaler Bearbeitungen einer Konfigurationsdatei stoppen

    git update-index --no-assume-unchanged config/local.yml
    # Normales Tracking fortsetzen

    git update-index --chmod=+x scripts/run.sh
    # Eine Datei ohne Inhaltänderung ausführbar machen

    git ls-files --debug
    # Index-Einträge mit ihren Flags anzeigen

Häufige Fehler

--assume-unchanged ist ein Performance-Hinweis und keine Sicherheitsmaßnahme — Git kann Änderungen trotzdem bemerken. Für Dateien, die Sie wirklich nie verfolgen wollen, ziehen Sie eine andere Lösung in Betracht (gitignore + Vorlagen-Datei).

Verwandte Befehle

git add, git rm, git ls-files, git read-tree