.gitignore-Generator-Leitfaden: Ignorierregeln nach Projekttyp schnell erstellen

Was ist .gitignore

Die Datei .gitignore teilt Git mit, welche Dateien/Verzeichnisse nicht versionskontrolliert werden sollen:

node_modules/       ← Ganzes Verzeichnis ignorieren
*.log               ← Alle Log-Dateien ignorieren
.env                ← Umgebungsvariablendatei ignorieren
dist/               ← Build-Ausgabe ignorieren

Nicht verfolgte Dateien, die .gitignore-Regeln entsprechen, werden von Git automatisch übersprungen. Bereits verfolgte Dateien sind nicht betroffen.

Syntaxregeln erklärt

Grundmuster

Syntax	Bedeutung	Beispiel
`*.ext`	Alle .ext-Dateien treffen	`*.log`
`dir/`	Ganzes Verzeichnis treffen	`node_modules/`
`file`	Bestimmte Datei treffen	`.env`
`**`	Beliebige Verzeichnisebene treffen	`**/test`
`?`	Einzelnes Zeichen treffen	`config?.json`
`[abc]`	Beliebiges Zeichen in Klammern treffen	`file[123].txt`

Negationsmuster `!`

*.log           ← Alle Logs ignorieren
!important.log  ← Aber important.log behalten

Negationsmuster müssen nach der Ignorierregel stehen, die sie negieren.

Pfadregeln

/README.md      ← Nur README.md auf Root-Ebene ignorieren
README.md       ← README.md auf jeder Ebene ignorieren
docs/*.pdf      ← PDFs in docs/ ignorieren, nicht rekursiv
docs/**/*.pdf   ← PDFs in allen Unterverzeichnissen von docs/ ignorieren

Gängige Projektvorlagen

Node.js

node_modules/
dist/
build/
.next/
.env
.env.local
*.log
coverage/

Python

__pycache__/
*.py[cod]
*.egg-info/
dist/
.venv/
venv/
.env
.pytest_cache/
.mypy_cache/

Java / Spring Boot

target/
*.class
*.jar
*.war
.gradle/
.idea/
*.iml
application-local.yml

IDE / Editoren

# VS Code
.vscode/

# IntelliJ IDEA
.idea/
*.iml

# macOS
.DS_Store

# Windows
Thumbs.db

Verwendung des gitignore-Tools

Schritt 1: Tool öffnen

Besuchen Sie das gitignore-Tool, um die Generator-Oberfläche aufzurufen.

Schritt 2: Projekttyp auswählen

Markieren Sie den in Ihrem Projekt verwendeten Tech-Stack:

☑ Node.js
☑ Python
☑ Java
☑ Vue / React / Angular

Schritt 3: IDE auswählen

Markieren Sie die von Ihrem Team verwendeten Editoren:

☑ VS Code
☑ IntelliJ IDEA
☑ Andere

Schritt 4: Generieren und herunterladen

Klicken Sie auf „Generieren". Das Tool führt automatisch alle Vorlagen zusammen, entfernt Duplikate und erstellt eine vollständige .gitignore-Datei.

Schritt 5: Im Projektstamm ablegen

Legen Sie die heruntergeladene Datei im Stammverzeichnis Ihres Git-Repositorys ab. Stellen Sie sicher, dass der Dateiname .gitignore lautet (beachten Sie den führenden Punkt).

Globales gitignore

Neben dem projektbezogenen .gitignore können Sie globale Ignorierregeln festlegen (gilt für alle Repos):

# Globale gitignore-Datei festlegen
git config --global core.excludesFile ~/.gitignore_global

# Globale Regeln bearbeiten
vim ~/.gitignore_global

Empfohlene globale Ignorierungen:

# Systemdateien
.DS_Store
Thumbs.db

# IDE-Konfigurationen
.idea/
.vscode/

# Persönliche Tools
.todo

Globale Regeln gelten für persönliche Umgebungsdateien. Projektbezogene Regeln gelten für projektspezifische Dateien.

Umgang mit bereits verfolgten Dateien

.gitignore betrifft nur nicht verfolgte Dateien. Wenn eine Datei bereits von Git verfolgt wird:

# Verfolgung beenden, aber lokale Datei behalten
git rm --cached .env

# Ganzes Verzeichnis nicht mehr verfolgen
git rm -r --cached node_modules/

# Änderung der Verfolgung beenden committen
git commit -m "chore: update gitignore and untrack files"

Das Flag --cached stellt sicher, dass nur aus dem Git-Index entfernt wird, ohne die lokale Datei zu löschen.

Häufige Fehler

Fehler	Ursache	Lösung
Regel funktioniert nicht	Datei bereits verfolgt	Zuerst `git rm --cached` ausführen
Negation funktioniert nicht	`!` vor der Ignorierregel platziert	`!`-Regel nach der entsprechenden Ignorierregel verschieben
Zu viel ignoriert	Muster zu breit	`/` verwenden, um den Pfadbereich einzuschränken
.env vergessen zu ignorieren	Env-Variablen-Vorlage fehlt	Immer `.env` zum .gitignore hinzufügen
Team-Regeln inkonsistent	Keine einheitliche Vorlage	Das Tool verwenden, um eine Standardvorlage zu generieren

.gitignore und .gitkeep

Nach dem Ignorieren eines Verzeichnisses verfolgt Git keine leeren Verzeichnisse. Um die leere Verzeichnisstruktur zu erhalten:

logs/           ← .gitignore ignoriert logs
logs/.gitkeep   ← .gitkeep-Platzhalter, erhält das Verzeichnis

.gitkeep ist keine Git-Funktion — es ist eine Community-Konvention. Platzieren Sie eine .gitkeep-Datei im leeren Verzeichnis.

Zusammenfassung

.gitignore ist grundlegend für die Projektkonfiguration. Korrekte Ignorierregeln verhindern das Committen sensibler Informationen und redundanter Dateien. Beherrschen Sie die Syntax, gängige Vorlagen und die globale Konfiguration, und verwenden Sie das gitignore-Tool zur schnellen Generierung — es ist der erste Schritt zur effektiven Versionskontrolle.