Ein einziges .gitignore für Ihren gesamten Stack
Dieser .gitignore-Generator kombiniert fertige Vorlagen für Programmiersprachen, Frameworks, Build-Tools, Editoren und Betriebssysteme in einer einzigen Datei. Wählen Sie Node und Next.js, fügen Sie macOS, Windows und VS Code hinzu, und Sie erhalten eine übersichtlich gegliederte .gitignore-Datei ohne doppelte Regeln und mit Platz für eigene Pfade. Die Vorlagen stammen aus der bewährten github/gitignore-Sammlung und werden vollständig in Ihrem Browser zusammengestellt.
So erstellen Sie eine .gitignore-Datei
- 1Geben Sie eine Sprache, ein Framework, einen Editor oder ein OS in das Suchfeld ein —
python,unity,jetbrains— und klicken Sie darauf. Enter wählt den ersten Treffer aus. - 2Kombinieren Sie beliebig viele Vorlagen für Ihr Projekt. Ein typisches Webprojekt kombiniert Sprache, Framework, Editor und Betriebssystem.
- 3Tragen Sie projektspezifische Pfade unter Eigene Zeilen ein, z. B.
/uploads/oder*.sqlite. - 4Kopieren Sie das Ergebnis oder laden Sie es mit Herunterladen als
.gitignorein das Hauptverzeichnis Ihres Git-Repositorys herunter.
Wozu eine .gitignore-Datei dient
Eine .gitignore-Datei listet Dateien auf, die Git nicht versionieren soll: Abhängigkeiten aus Paketmanagern (node_modules/, vendor/), Build-Ausgaben (dist/, target/), Caches, Protokolle, Editor-Einstellungen und geheime Schlüssel wie .env. Das Halten dieser Dateien außerhalb des Repositorys hält es schlank, macht Diffs lesbar und verhindert versehentliche Datenlecks.
Die Datei betrifft nur noch nicht versionierte Dateien (untracked). Wurde eine Datei bereits committet, wird sie durch das Eintragen in .gitignore nicht gelöscht; führen Sie git rm --cached <datei> (oder git rm -r --cached <ordner>) aus und committen Sie die Änderung, um die Datei nicht mehr zu verfolgen, während die lokale Kopie erhalten bleibt.
Syntax von .gitignore-Mustern
Die Reihenfolge entscheidet: Die letzte passende Regel gewinnt. Aus diesem Grund müssen Ausnahmen wie !.vscode/settings.json nach der allgemeinen Regel .vscode/* stehen.
- *.log
- Ein Muster ohne Schrägstrich greift in jeder Verzeichnistiefe: ignoriert alle .log-Dateien im Repository.
- /build
- Ein führender Schrägstrich verankert das Muster im Verzeichnis der .gitignore, ignoriert also nur den Build-Ordner auf oberster Ebene.
- dist/
- Ein nachgestellter Schrägstrich ignoriert nur Verzeichnisse, keine reguläre Datei namens dist.
- **/temp
- Zwei Sternchen stehen für beliebige Verzeichnisebenen: ein temp-Ordner im Stammverzeichnis oder in Unterordnern.
- !.env.example
- Ein vorangestelltes Ausrufezeichen schließt eine zuvor ignorierte Datei wieder ein. Funktioniert nicht, wenn der übergeordnete Ordner ignoriert wird.
- # kommentar
- Zeilen mit # am Anfang sind Kommentare; Leerzeilen dienen als Trenner. Stellen Sie einen Backslash vor # oder !, um sie wörtlich zu prüfen.
Wie Vorlagen zusammengeführt werden
Jede Vorlage bildet einen eigenen Abschnitt mit dem Titel ### Name ###. Wenn Doppelte Muster entfernen aktiviert ist, werden bereits vorhandene Muster in späteren Abschnitten ausgelassen und leere Kommentarblöcke bereinigt, damit die Datei übersichtlich bleibt. Negierte Muster bleiben an ihrer Stelle, um ihre logische Wirkung zu wahren.
Vorlagen für Build-Tools und Frameworks überschneiden sich oft — Node, Next.js und Vite ignorieren alle node_modules und Logdateien —, sodass das Entfernen von Duplikaten die Dateilänge meist um 20 % oder mehr reduziert.
Projektweite, globale und lokale Ignore-Dateien
Committen Sie die .gitignore des Projekts, damit alle Teammitglieder dieselben Regeln nutzen, und beschränken Sie sie auf Dateien, die das Projekt selbst erzeugt. Dateien Ihres eigenen Systems — .DS_Store, Thumbs.db, Editor-Ordner — gehören in eine globale Ignore-Datei via git config --global core.excludesFile ~/.gitignore_global. Für Regeln, die nur für Sie in einem bestimmten Repository gelten, nutzen Sie .git/info/exclude.
Lock-Dateien wie package-lock.json, poetry.lock und Cargo.lock sollten committet werden, um reproduzierbare Installationen sicherzustellen. Um zu prüfen, welche Regel eine Datei ignoriert, führen Sie git check-ignore -v pfad/zur/datei aus.
Geheimnisse und Zugangsdaten schützen
Die Vorlage Env & Geheimnisse ignoriert .env-Dateien, private Schlüssel und Zugangsdaten, behält aber .env.example für Dokumentationszwecke bei. Das Ignorieren schützt nur zukünftige Commits: Wurde ein Schlüssel bereits committet, erneuern Sie ihn sofort, da er im Git-Verlauf bleibt. Verwandte Tools: chmod-Rechner für Dateiberechtigungen und robots.txt-Generator für Web-Crawler.
Häufige Fragen
- Wohin gehört die .gitignore-Datei?
- In das Wurzelverzeichnis Ihres Repositorys, direkt neben den .git-Ordner. Sie können auch .gitignore-Dateien in Unterverzeichnissen anlegen; deren Regeln gelten dann relativ zu diesem Ordner.
- Warum wird eine Datei trotz Eintrag in .gitignore weiter verfolgt?
- .gitignore wirkt nur auf noch nicht verfolgte Dateien. Führen Sie git rm --cached <datei> (oder git rm -r --cached <ordner>) aus und committen Sie, damit Git die Datei nicht mehr verfolgt, während Ihre lokale Datei erhalten bleibt.
- Sollte ich package-lock.json oder yarn.lock ignorieren?
- Nein, bei Anwendungen nicht. Lock-Dateien sichern exakte Paketversionen für identische Installationen und gehören ins Repository. Ignorieren Sie nur Lock-Dateien von Tools, die Sie nicht nutzen.
- Gehören .vscode oder .idea in die .gitignore?
- Meist nur die persönlichen Einstellungen. Die VS Code Vorlage ignoriert .vscode/*, behält aber gemeinsame settings.json, tasks.json und launch.json bei; die JetBrains-Vorlage ignoriert den gesamten .idea-Ordner.
- Wie ignoriere ich .DS_Store projektübergreifend?
- Erstellen Sie eine globale Ignore-Datei: legen Sie ~/.gitignore_global mit .DS_Store an und führen Sie git config --global core.excludesFile ~/.gitignore_global aus.
- Wie ignoriere ich alles in einem Ordner außer einer Datei?
- Ignorieren Sie den Inhalt statt des Ordners selbst: ordner/* gefolgt von !ordner/behalten.txt. Ein Muster wie ordner/ ignoriert das Verzeichnis komplett, sodass keine Datei darin wieder eingeschlossen werden kann.
- Woher stammen diese Vorlagen?
- Sie basieren auf dem offiziellen github/gitignore-Repository unter CC0-Lizenz, bereinigt um veraltete Einträge. Passen Sie die Regeln bei Bedarf an die Anforderungen Ihres Projekts an.