Start·Terminal-Befehle

git ls-files

git

Aufruf

git ls-files [-o|-m|-i] [--exclude-standard]

Listet Pfade aus dem Index statt von der Platte und ist damit die verlässliche Liste für Skripte; -i geht nicht allein, es braucht -c oder -o samt --exclude-standard.

Häufige Optionen

OptionBedeutung
-cfiles in the index; the default
-mtracked files modified on disk
-dtracked files that are missing
-ofiles git does not track
-iignored files; must come with -o or -c and --exclude-standard
--exclude-standardapply .gitignore and friends
-sshow mode and object id of each entry
-zseparate paths with NUL for xargs -0

Beispiele

git ls-files

every tracked path, straight from the index

git ls-files -o --exclude-standard

untracked files only, respecting .gitignore

git ls-files -i -c --exclude-standard

tracked files that .gitignore says should be ignored

Verwirrend ist, dass Rückgängig mehrere Formen hat — den Zeiger eines Branch zu verschieben ist nicht dasselbe wie einen Gegen-Commit zu setzen.

So liest man das

  • Eckige Klammern [ ] markieren einen Teil, den man weglassen kann.
  • Drei Punkte … heißen: mehrere sind erlaubt.
  • Optionen achten auf Groß- und Kleinschreibung — bei manchen Befehlen sind -r und -R verschieden.

Häufige Fragen

Q. Was macht git ls-files?

Listet Pfade aus dem Index statt von der Platte und ist damit die verlässliche Liste für Skripte; -i geht nicht allein, es braucht -c oder -o samt --exclude-standard.

Q. Wie gibt man ihn ein?

git ls-files [-o|-m|-i] [--exclude-standard] — eckige Klammern markieren, was wegfallen darf.

Q. Wie viele Optionen lohnen sich?

Hier stehen 8; die vollständige Liste steht in man git. Der Befehl gehört zu git.

Verwandte Befehle

man-Seite: man git-ls-files