Muster, die von der Befehlszeile für die Befehle gelesen werden, die sie unterstützen.

Muster, die aus einer .gitignore-Datei im selben Verzeichnis wie der Pfad oder in einem beliebigen übergeordneten Verzeichnis (bis zur obersten Ebene des Arbeitsbaums) gelesen werden, wobei Muster in den höherrangigen Dateien durch solche in niedrigerrangigen Dateien überschrieben werden, bis hinunter zum Verzeichnis, das die Datei enthält. Diese Muster stimmen relativ zum Speicherort der .gitignore-Datei überein. Ein Projekt enthält normalerweise solche .gitignore-Dateien in seinem Repository, die Muster für Dateien enthalten, die als Teil des Projekt-Builds generiert wurden.

Muster, die aus $GIT_DIR/info/exclude gelesen werden.

Muster, die aus der Datei gelesen werden, die durch die Konfigurationsvariable core.excludesFile angegeben ist.

Muster, die versioniert und über Klone an andere Repositories verteilt werden sollen (d. h. Dateien, die alle Entwickler ignorieren möchten), sollten in eine .gitignore-Datei geschrieben werden.

Muster, die für ein bestimmtes Repository spezifisch sind, aber nicht mit anderen verwandten Repositories geteilt werden müssen (z. B. Hilfsdateien, die sich im Repository befinden, aber für den Workflow eines einzelnen Benutzers spezifisch sind), sollten in die Datei $GIT_DIR/info/exclude geschrieben werden.

Muster, die ein Benutzer Git in allen Situationen ignorieren lassen möchte (z. B. Sicherungs- oder temporäre Dateien, die vom bevorzugten Editor des Benutzers generiert werden), werden im Allgemeinen in eine Datei geschrieben, die durch core.excludesFile in der ~/.gitconfig des Benutzers angegeben ist. Ihr Standardwert ist $XDG_CONFIG_HOME/git/ignore. Wenn $XDG_CONFIG_HOME entweder nicht gesetzt oder leer ist, wird stattdessen $HOME/.config/git/ignore verwendet.

Eine leere Zeile passt zu keinen Dateien, daher kann sie als Trennzeichen zur besseren Lesbarkeit dienen.

Eine Zeile, die mit # beginnt, dient als Kommentar. Setzen Sie einen Schrägstrich ("\") vor den ersten Hash für Muster, die mit einem Hash beginnen.

Nachgestellte Leerzeichen werden ignoriert, es sei denn, sie werden mit einem Schrägstrich ("\") in Anführungszeichen gesetzt.

Ein optionales Präfix "!", das das Muster negiert; jede übereinstimmende Datei, die von einem vorherigen Muster ausgeschlossen wurde, wird wieder eingeschlossen. Es ist nicht möglich, eine Datei wieder einzuschließen, wenn ein Elternverzeichnis dieser Datei ausgeschlossen ist. Git listet aus Performance-Gründen keine ausgeschlossenen Verzeichnisse auf, daher haben Muster auf enthaltene Dateien keine Wirkung, unabhängig davon, wo sie definiert sind. Setzen Sie einen Schrägstrich ("\") vor das erste "!" für Muster, die mit einem wörtlichen "!" beginnen, z. B. "\!important!.txt".

Der Schrägstrich "/" wird als Verzeichnistrenner verwendet. Trennzeichen können am Anfang, in der Mitte oder am Ende des .gitignore-Suchmusters vorkommen.

Wenn sich am Anfang oder in der Mitte (oder beidem) des Musters ein Trennzeichen befindet, dann ist das Muster relativ zur Verzeichnisebene der jeweiligen .gitignore-Datei selbst. Andernfalls kann das Muster auch auf jeder Ebene unterhalb der .gitignore-Ebene passen.

Wenn sich am Ende des Musters ein Trennzeichen befindet, passt das Muster nur zu Verzeichnissen, andernfalls kann das Muster sowohl zu Dateien als auch zu Verzeichnissen passen.

Zum Beispiel passt das Muster doc/frotz/ zum Verzeichnis doc/frotz, aber nicht zum Verzeichnis a/doc/frotz; frotz/ passt jedoch zu frotz und a/frotz, was ein Verzeichnis ist (alle Pfade sind relativ zur .gitignore-Datei).

Ein Sternchen "*" passt zu allem außer einem Schrägstrich. Das Zeichen "?" passt zu jedem einzelnen Zeichen außer "/". Die Bereichsschreibweise, z. B. [a-zA-Z], kann verwendet werden, um eines der Zeichen in einem Bereich abzugleichen. Siehe fnmatch(3) und das FNM_PATHNAME-Flag für eine detailliertere Beschreibung.

Ein Schrägstrich ("\") kann verwendet werden, um jedes Zeichen zu escapen. Z. B. passt "\*" zu einem wörtlichen Sternchen (und "\a" passt zu "a", auch wenn hier keine Maskierung erforderlich ist). Wie bei fnmatch(3) ist ein Schrägstrich am Ende eines Musters ein ungültiges Muster, das nie passt.

Ein führendes "**" gefolgt von einem Schrägstrich bedeutet "in allen Verzeichnissen abgleichen". Zum Beispiel passt "**/foo" zur Datei oder zum Verzeichnis "foo" überall, genauso wie das Muster "foo". "**/foo/bar" passt zur Datei oder zum Verzeichnis "bar" überall, das sich direkt unter dem Verzeichnis "foo" befindet.

Ein nachgestelltes "/**" passt zu allem darunter. Zum Beispiel passt "abc/**" zu allen Dateien innerhalb des Verzeichnisses "abc", relativ zum Speicherort der .gitignore-Datei, mit unendlicher Tiefe.

Ein Schrägstrich gefolgt von zwei aufeinanderfolgenden Sternchen und dann einem Schrägstrich passt zu null oder mehr Verzeichnissen. Zum Beispiel passt "a/**/b" zu "a/b", "a/x/b", "a/x/y/b" und so weiter.

Andere aufeinanderfolgende Sternchen werden als reguläre Sternchen betrachtet und passen gemäß den vorherigen Regeln.

Das Muster hello.* passt zu jeder Datei oder jedem Verzeichnis, dessen Name mit hello. beginnt. Wenn man dies nur auf das Verzeichnis und nicht auf seine Unterverzeichnisse beschränken möchte, kann man dem Muster einen Schrägstrich voranstellen, d. h. /hello.*; das Muster passt nun zu hello.txt, hello.c, aber nicht zu a/hello.java.

Das Muster foo/ passt zu einem Verzeichnis foo und Pfaden darunter, passt aber nicht zu einer regulären Datei oder einem symbolischen Link foo (dies ist konsistent mit der Art und Weise, wie Pfadangaben im Allgemeinen in Git funktionieren)

Die Muster doc/frotz und /doc/frotz haben in jeder .gitignore-Datei dieselbe Wirkung. Mit anderen Worten, ein führender Schrägstrich ist nicht relevant, wenn bereits ein mittlerer Schrägstrich im Muster vorhanden ist.

Das Muster foo/* passt zu foo/test.json (einer regulären Datei), foo/bar (einem Verzeichnis), passt aber nicht zu foo/bar/hello.c (einer regulären Datei), da der Stern im Muster nicht zu bar/hello.c passt, das einen Schrägstrich enthält.