Gitignore bleibt wirkungslos: Wie gitslip veraltete Dateien aufspürt

Das .gitignore-Verzeichnis ist ein mächtiges Werkzeug, um ungewollte Dateien aus einem Git-Repository auszuschließen. Doch viele Entwickler:innen übersehen einen entscheidenden Umstand: Sobald eine Datei bereits einem Repository hinzugefügt wurde, ignoriert Git die entsprechenden Regeln in .gitignore einfach. Das bedeutet, dass sensible Daten oder große Build-Artifacts weiterhin im Repository verbleiben – selbst wenn sie eigentlich ausgeschlossen werden sollten.

Das Problem besteht darin, dass .gitignore nur für unverfolgte Dateien gilt. Sobald eine Datei einmal committet wurde, spielt die Ignorier-Regel keine Rolle mehr. Viele Nutzer:innen merken dies erst, wenn es zu spät ist – etwa wenn geheime Umgebungsvariablen oder temporäre Log-Dateien versehentlich öffentlich werden. Die Lösung wäre einfach: mit dem Befehl git rm --cached lassen sich die Dateien aus dem Repository entfernen, ohne sie lokal zu löschen. Doch wer scannt schon regelmäßig nach solchen „Geistern-Dateien“?

Genau hier setzt gitslip an, ein neues Kommandozeilen-Tool, das genau diese Problematik angeht. Die Software durchsucht gezielt nach Dateien, die zwar in .gitignore aufgelistet sind, aber trotzdem noch im Repository verfolgt werden. Statt manuell nach versteckten Dateien zu suchen, liefert gitslip eine klare Übersicht – inklusive der genauen Zeile in der .gitignore-Datei, die das Ignorieren der Datei vorgibt.

Warum gitslip besser ist als ein manuelles grep

Ein einfacher grep-Befehl mag auf den ersten Blick ausreichen, um nach .env-Dateien zu suchen. Doch diese Methode hat entscheidende Nachteile:

• Ein regulärer Ausdruck wie grep '\.env' kann nicht zwischen korrekt ignorierten und versehentlich verfolgten Dateien unterscheiden.
• Negationsregeln (z. B. !important.env), Verzeichnis-spezifische .gitignore-Dateien oder globale Ausnahmen werden nicht berücksichtigt.
• Selbst wenn man versucht, die Logik von .gitignore nachzubauen, besteht die Gefahr, dass die Implementierung nicht mit Git selbst übereinstimmt – was zu falschen Ergebnissen führen kann.

gitslip umgeht diese Probleme, indem es direkt auf Git-Befehle zurückgreift. Die Software nutzt die interne Logik von Git, um zuverlässig zu bestimmen, welche Dateien ignoriert werden sollten – aber trotzdem noch verfolgt werden.

So funktioniert die Erkennung im Hintergrund

Der Kern von gitslip basiert auf einem einzigen Git-Befehl, der die korrekten Informationen liefert:

git ls-files -i -c --exclude-standard

Der Befehl kombiniert drei wichtige Optionen:

• -i (ignored): Listet nur ignorierte Dateien.
• -c (cached): Zeigt nur Dateien an, die Git aktuell verfolgt.
• --exclude-standard: Berücksichtigt alle Standard-Quellen für Ignorier-Regeln, einschließlich .gitignore, .git/info/exclude und globale Konfigurationen.

Das Ergebnis ist eine Liste aller Dateien, die sowohl ignoriert als auch verfolgt werden – ein Zustand, der normalerweise nicht vorkommen sollte, aber oft der Fall ist, wenn .gitignore nachträglich angepasst wurde.

Die Herausforderung: Welche Regel ignoriert die Datei?

Ein weiteres Problem besteht darin, die genaue .gitignore-Regel zu ermitteln, die für eine ignorierte, aber verfolgte Datei zuständig ist. Git stellt dafür den Befehl git check-ignore -v bereit, der normalerweise die passende Regel anzeigt. Doch dieser Befehl scheitert oft, wenn die Datei bereits verfolgt wird – er gibt dann einfach aus, dass die Datei nicht ignoriert wird.

gitslip löst dieses Problem mit einem cleveren Workaround: Die Datei wird gegen einen leeren Git-Index geprüft. Durch die Umgebungsvariable GIT_INDEX_FILE=/tmp/empty wird Git angewiesen, einen nicht existierenden Index zu verwenden – was effektiv einem leeren Index entspricht. Dadurch wird die Datei als „nicht verfolgt“ behandelt, und git check-ignore -v kann die passende Regel korrekt identifizieren.

Installation und Anwendung

gitslip ist in zwei Versionen verfügbar – als Node.js- und als Python-Tool. Beide Varianten sind voneinander unabhängig, liefern aber identische Ergebnisse. Die Installation ist denkbar einfach:

Node.js:

npx gitslip

Python:

pip install gitslip

Nach der Installation kann das Tool direkt im Projektverzeichnis ausgeführt werden. gitslip zeigt dann alle Dateien an, die ignoriert werden sollten, aber trotzdem verfolgt werden – inklusive der genauen .gitignore-Zeile, die für die Ignorierung verantwortlich ist. Mit der Option --apply führt das Tool die notwendigen git rm --cached-Befehle direkt aus, ohne die lokalen Dateien zu löschen.

Ein weiterer Vorteil: gitslip eignet sich auch als automatische Prüfung in CI-Pipelines. Wenn das Tool eine ignorierte, aber verfolgte Datei findet, bricht es mit einem Exit-Code 1 ab – was ideal ist, um versehentliche Commits zu verhindern.

Fazit: Ein Tool für mehr Sicherheit in Git-Repositories

gitslip ist ein kleines, aber mächtiges Werkzeug, das Entwickler:innen dabei hilft, häufige Fehler in Git-Workflows zu vermeiden. Indem es ignorierte, aber verfolgte Dateien zuverlässig aufspürt, trägt es dazu bei, sensible Daten oder große, unnötige Dateien aus Repositories fernzuhalten. Besonders in Teams, in denen .gitignore-Regeln oft erst nachträglich angepasst werden, kann gitslip den Unterschied zwischen einem sicheren und einem potenziell riskanten Repository ausmachen.

Probieren Sie gitslip noch heute in Ihrem Projekt aus – die Wahrscheinlichkeit ist hoch, dass Sie dabei auf versteckte Dateien stoßen, die besser ignoriert würden.