Übersicht

git ls-files [-c] [-d] [-m] [-o] [-i] [--exclude-standard]

Beschreibung

Der git ls-files-Befehl listet Dateien auf, die Gits Index (und optional dem Working Tree) bekannt sind. Er unterstützt Filter: cached/staged, deleted, modified, others (untracked), ignored, unmerged usw. Er ist schneller und präziser als find für "zeige mir alle verfolgten Dateien".

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

Häufige Optionen

Option	Beschreibung
-c, --cached	Zeigt gecachte Dateien (Standard).
-d	Zeigt gelöschte Dateien.
-m	Zeigt modifizierte Dateien.
-o	Zeigt andere (untracked) Dateien.
-i	Zeigt ignorierte Dateien.
--exclude-standard	Wendet Standard-Ignore-Regeln an.
-s, --stage	Zeigt Stage-Info (für unmerged Pfade).
-z	NUL-terminierte Ausgabe.

Beispiele

git ls-files
    # Jede verfolgte Datei

    git ls-files -o --exclude-standard
    # Untracked, nicht ignorierte Dateien

    git ls-files -m
    # Lokal modifizierte verfolgte Dateien

    git ls-files -s
    # Modus, SHA und Stage-Nummer für jeden Eintrag anzeigen

Häufige Fehler

--exclude-standard beim Auflisten untracked Dateien zu vergessen, überschwemmt Sie mit ignoriertem Müll. Filter zu kombinieren kann verwirrend sein — wenn Sie sowohl -c als auch -o übergeben, hängt die Bedeutung vom Kontext ab.

Verwandte Befehle

git status, git ls-tree, git update-index, git grep