Was ist eine .gitignore-Datei und wie wird sie verwendet?

Question

Accepted Answer

Eine **.gitignore**-Datei teilt Git mit, welche Dateien und Verzeichnisse **ignoriert** werden — nicht im Versionskontrollsystem nachverfolgt. Sie wird verwendet, um generierte Dateien, Abhängigkeiten, Geheimnisse und umgebungsspezifische Dateien auszuschließen, die nicht committed werden sollten.

## Was .gitignore bewirkt

```text
# .gitignore — patterns of files Git should NOT track
node_modules/          # dependencies (reinstalled from package files, don't commit)
dist/                  # build output (generated, don't commit)
*.log                  # log files
.env                   # ⚠️ SECRETS / environment variables — NEVER commit!
.DS_Store              # OS-specific junk
.vscode/               # editor config (often personal)
build/
coverage/
*.tmp
```

Git ignoriert Dateien, die diesen Mustern entsprechen — sie erscheinen nicht in `git status`, werden nicht bereitgestellt und nicht committed.

## Mustersyntax

```text
node_modules/    → ignore a directory (and everything in it)
*.log            → ignore all files with a .log extension
!important.log   → EXCEPTION: do NOT ignore this (negation)
/build           → ignore "build" only in the root (leading slash = root-relative)
doc/*.txt        → .txt files in doc/ but not subdirectories
**/temp          → "temp" anywhere in the tree
```

## Was ignoriert werden sollte (häufige Kategorien)

```text
✓ DEPENDENCIES — node_modules/, vendor/ (reinstalled from manifests; huge, don't commit)
✓ BUILD OUTPUT — dist/, build/, *.o (generated from source)
✓ SECRETS — .env, credentials, keys (⚠️ NEVER commit secrets — a serious security issue)
✓ ENVIRONMENT/OS/EDITOR files — .DS_Store, .idea/, .vscode/ (personal/machine-specific)
✓ LOGS, caches, temp files
```

```text
⚠️ Already-tracked files aren't ignored by adding them later — untrack first:
   git rm --cached <file>   (then commit; .gitignore prevents re-adding)
```

## Warum es wichtig ist

Das Verständnis von `.gitignore` ist wichtig für das **Halten von Repositories sauber und sicher**, daher ist es wesentliches praktisches Git-Wissen.

Eine `.gitignore`-Datei schließt Dateien aus, die **nicht im Versionskontrollsystem sein sollten**, und adressiert mehrere praktische Anforderungen.

Sie hält Repositories sauber, indem sie **generierte/abgeleitete Dateien** (Build-Ausgaben, kompilierte Artefakte) und **Abhängigkeiten** (`node_modules`, die groß sind und aus Manifest-Dateien neu installiert werden — das Committen würde das Repository aufblähen) ausschließt — so enthält das Repository nur die aussagekräftige Quelle.

Sie schließt **umgebungsspezifische und persönliche Dateien** aus (Betriebssystem-Müll wie `.DS_Store`, Editor-Konfigurationen), die das Repository überfüllen und Noise verursachen würden.

Am wichtigsten ist, dass sie **wesentlich für die Sicherheit** ist: Das Ausschließen von **Geheimnissen** (`.env`-Dateien, Anmeldedaten, API-Schlüssel) ist kritisch, weil das **Committen von Geheimnissen ein schwerwiegender Sicherheitsfehler** ist — einmal committed, befinden sich Geheimnisse in der Versionsgeschichte des Repositories (und möglicherweise wurden sie in Remote-/öffentliche Repositories gepusht, wo sie ausgenutzt werden können), daher ist `.gitignore` eine Schlüsselverteidigung gegen versehentliches Committen sensibler Daten.

Das Verständnis der **Mustersyntax** (Verzeichnisse, Wildcards, Negation, Root-relativ) ermöglicht das Schreiben effektiver Ignore-Regeln, und das Wissen über die wichtige Besonderheit, dass **bereits verfolgte Dateien deaktiviert werden müssen** (`git rm --cached`), bevor `.gitignore` wirksam wird, verhindert eine häufige Verwirrung.

Da saubere Repositories (keine generierten Dateien, Abhängigkeiten oder Unordnung) und besonders das **Nicht-Committen von Geheimnissen** für die Repository-Qualität und Sicherheit wichtig sind, und da `.gitignore` der Standard-Mechanismus zum Ausschließen von Dateien ist, die nicht nachverfolgt werden sollten, ist das Verständnis von `.gitignore` — was ignoriert werden sollte (Abhängigkeiten, Build-Ausgaben und besonders kritisch Geheimnisse), die Mustersyntax und die Deaktivierungs-Besonderheit — wesentliches, häufig angewendetes Git-Wissen zur Aufrechterhaltung sauberer, sicherer Repositories, wobei der Sicherheitsaspekt des Haltens von Geheimnissen außerhalb der Versionskontrolle besonders wichtig ist.