.gitignore-Leitfäden
Von der Mustersyntax über den Vorrang, die globale Konfiguration und bereits committete Dateien bis zur Fehlersuche — auf Grundlage der offiziellen git-Dokumentation.
.gitignore-Mustersyntax im Überblick
Die gitignore-Mustersyntax mit Beispieltabellen: Kommentare, Escaping und nachgestellte Leerzeichen, Negation mit !, abschließender Schrägstrich, Verankerung, die Platzhalter *, ? und [] sowie die Regeln für **.
gitignore-Vorrang und Negationsmuster (!)
Warum die letzte Regel gewinnt, wie der Vorrang zwischen .gitignore, info/exclude und globaler Konfiguration geregelt ist, und warum ! eine Datei in einem ausgeschlossenen Elternverzeichnis nicht zurückholen kann – samt Lösung.
Globale gitignore einrichten (core.excludesFile)
So richten Sie core.excludesFile ein, damit Dateien aus Ihrer persönlichen Umgebung wie .DS_Store von macOS oder Editordateien in allen Repositorys ignoriert werden – inklusive Standardpfad.
Eigene Ausschlussregeln mit .git/info/exclude
So schreiben Sie persönliche Ausschlussregeln, die nur für ein einzelnes Repository gelten, in .git/info/exclude, ohne die .gitignore zu ändern – mit passenden Einsatzfällen und Vorrang.
Bereits committete Dateien mit .gitignore ignorieren
So nehmen Sie Dateien, die trotz .gitignore weiter verfolgt werden, mit git rm --cached aus dem Tracking, finden verfolgte Dateien, auf die Ausschlussregeln passen, und gehen vor, wenn Geheimnisse committet wurden.
Warum wird das ignoriert? Fehlersuche mit git check-ignore
So finden Sie mit git check-ignore -v, git status --ignored und git ls-files heraus, welche Regel eine Datei ignoriert, und prüfen sieben häufige Ursachen, wenn eine Regel nicht greift.
Was ignorieren, was committen?
Kriterien dafür, Build-Artefakte, Abhängigkeiten, Caches und Geheimnisse zu ignorieren, aber Lockfiles, Beispielkonfigurationen und abgestimmte Editoreinstellungen zu committen – dazu .gitignore in Unterverzeichnissen, leere Verzeichnisse und Tipps zum Zusammenführen von Vorlagen.