English ▾ Themen ▾ Neueste Version ▾ git-check-ignore zuletzt aktualisiert in 2.52.0

NAME

git-check-ignore - Gitignore / Ausschlussdateien debuggen

SYNOPSIS

git check-ignore [<options>] <pathname>…​
git check-ignore [<options>] --stdin

BESCHREIBUNG

Für jeden über die Kommandozeile oder aus einer Datei über --stdin gegebenen Pfadnamen wird geprüft, ob die Datei durch .gitignore (oder andere Eingabedateien des Ausschließlichkeitsmechanismus) ausgeschlossen wird, und der Pfad wird ausgegeben, wenn er ausgeschlossen ist.

Standardmäßig werden nachverfolgte Dateien überhaupt nicht angezeigt, da sie keinen Ausschlussregeln unterliegen; siehe aber '--no-index'.

OPTIONEN

-q
--quiet

Nichts ausgeben, nur den Exit-Status setzen. Dies ist nur mit einem einzelnen Pfadnamen gültig.

-v
--verbose

Anstatt der ausgeschlossenen Pfade wird für jeden Pfad, der einem Ausschlussmuster entspricht, zusammen mit dem Pfad auch das Ausschlussmuster ausgegeben. (Einem Ausschlussmuster zu entsprechen bedeutet normalerweise, dass der Pfad ausgeschlossen wird, aber wenn das Muster mit '!' beginnt, handelt es sich um ein negiertes Muster, und ein Treffer bedeutet, dass der Pfad NICHT ausgeschlossen wird.)

Regeln für die Vorrangigkeit innerhalb und zwischen Ausschlussquellen finden Sie in gitignore[5].

--stdin

Liest Pfadnamen von der Standardeingabe, einen pro Zeile, anstatt von der Kommandozeile.

-z

Das Ausgabeformat wird auf maschinenlesbar geändert (siehe unten). Wenn auch '--stdin' angegeben ist, werden Eingabepfade durch ein NUL-Zeichen anstelle eines Zeilenumbruchs getrennt.

-n
--non-matching

Zeigt gegebene Pfade an, die keinem Muster entsprechen. Dies ist nur sinnvoll, wenn '--verbose' aktiviert ist, da es sonst nicht möglich wäre, zwischen Pfaden, die einem Muster entsprechen, und denen, die es nicht tun, zu unterscheiden.

--no-index

Ignoriert den Index bei der Durchführung der Prüfungen. Dies kann verwendet werden, um zu debuggen, warum ein Pfad durch z. B. git add . nachverfolgt wurde und nicht von den Regeln wie vom Benutzer erwartet ignoriert wurde, oder um Muster zu entwickeln, einschließlich Negationen, um einen Pfad abzugleichen, der zuvor mit git add -f hinzugefügt wurde.

AUSGABE

Standardmäßig werden alle gegebenen Pfadnamen, die einem Ignore-Muster entsprechen, zeilenweise ausgegeben. Wenn kein Muster auf einen gegebenen Pfad passt, wird nichts für diesen Pfad ausgegeben; dies bedeutet, dass der Pfad nicht ignoriert wird.

Wenn '--verbose' angegeben ist, ist die Ausgabe eine Serie von Zeilen der Form

<source> <COLON> <linenum> <COLON> <pattern> <HT> <pathname>

<pathname> ist der Pfad einer abgefragten Datei, <pattern> ist das übereinstimmende Muster, <source> ist die Quelldatei des Musters und <linenum> ist die Zeilennummer des Musters innerhalb dieser Quelle. Wenn das Muster ein '!'-Präfix oder ein '/'-Suffix enthielt, wird es in der Ausgabe beibehalten. <source> ist ein absoluter Pfad, wenn es sich auf die von core.excludesFile konfigurierte Datei bezieht, oder relativ zum Repository-Root, wenn es sich auf .git/info/exclude oder eine Verzeichnis-spezifische Ausschlussdatei bezieht.

Wenn '-z' angegeben ist, werden die Pfadnamen in der Ausgabe durch das Null-Zeichen getrennt; wenn auch '--verbose' angegeben ist, werden Null-Zeichen auch anstelle von Doppelpunkten und Tabulatoren verwendet

<source> <NULL> <linenum> <NULL> <pattern> <NULL> <pathname> <NULL>

Wenn '-n oder '--non-matching' angegeben ist, werden auch nicht übereinstimmende Pfadnamen ausgegeben, wobei in diesem Fall alle Felder in jeder Ausgabezeile außer <pathname> leer sind. Dies kann nützlich sein, wenn es nicht-interaktiv ausgeführt wird, sodass Dateien inkrementell an STDIN eines langlaufenden check-ignore-Prozesses gestreamt werden können und für jede dieser Dateien STDOUT angibt, ob diese Datei einem Muster entsprochen hat oder nicht. (Ohne diese Option wäre es unmöglich zu unterscheiden, ob die Abwesenheit einer Ausgabe für eine bestimmte Datei bedeutet, dass sie keinem Muster entsprochen hat, oder dass die Ausgabe noch nicht generiert wurde.)

Puffern erfolgt wie unter der Option GIT_FLUSH in git[1] dokumentiert. Der Aufrufer ist dafür verantwortlich, Deadlocks zu vermeiden, die durch ein Überfüllen eines Eingabepuffers oder das Lesen aus einem leeren Ausgabepuffer entstehen.

BEENDIGUNGSSTATUS

0

Ein oder mehrere der bereitgestellten Pfade werden ignoriert.

1

Keiner der bereitgestellten Pfade wird ignoriert.

128

Ein schwerwiegender Fehler ist aufgetreten.

SIEHE AUCH

gitignore[5] git-config[1] git-ls-files[1]

GIT

Teil der git[1] Suite