Überblick

Cursor liest und indexiert den Code deiner Projekte, um seine Features bereitzustellen. Steuere, auf welche Verzeichnisse und Dateien Cursor zugreifen kann, indem du eine .cursorignore-Datei im Root-Verzeichnis verwendest. Cursor blockiert den Zugriff auf in .cursorignore aufgeführte Dateien für:
Vom Agent initiierte Tool-Aufrufe, wie Terminal- und MCP-Server, können den Zugriff auf Code, der von .cursorignore gesteuert wird, nicht blockieren

Warum Dateien ignorieren?

Sicherheit: Beschränke den Zugriff auf API-Keys, Zugangsdaten und Secrets. Auch wenn Cursor ignorierte Dateien blockiert, ist vollständiger Schutz wegen der Unvorhersehbarkeit von LLMs nicht garantiert. Performance: In großen Codebases oder Monorepos irrelevante Bereiche ausschließen, um schneller zu indexieren und Dateien genauer zu finden.

Globale Ignore-Dateien

Leg in den Benutzereinstellungen projektübergreifende Ignore-Muster fest, um sensible Dateien ohne projektspezifische Konfiguration auszuschließen.
Globale Cursor-Ignore-Liste
Standardmuster sind:
  • Umgebungsdateien: **/.env, **/.env.*
  • Zugangsdaten: **/credentials.json, **/secrets.json
  • Schlüssel: **/*.key, **/*.pem, **/id_rsa

Konfigurieren von .cursorignore

Erstelle im Projektstamm eine .cursorignore-Datei mit .gitignore-Syntax.

Musterbeispiele

config.json      # Konkrete Datei
dist/            # Verzeichnis
*.log            # Dateierweiterung
**/logs          # Verschachtelte Verzeichnisse
!app/            # Vom Ignorieren ausnehmen (Negation)

Hierarchisches Ignorieren

Aktiviere Cursor Settings > Features > Editor > Hierarchical Cursor Ignore, um in übergeordneten Verzeichnissen nach .cursorignore-Dateien zu suchen. Hinweise: Kommentare beginnen mit #. Spätere Muster überschreiben frühere. Muster sind relativ zum Speicherort der Datei.

Indexierung mit .cursorindexingignore einschränken

Verwende .cursorindexingignore, um Dateien ausschließlich von der Indexierung auszuschließen. Diese Dateien bleiben für AI-Features zugänglich, tauchen aber nicht in Codebase-Suchen auf.

Standardmäßig ignorierte Dateien

Cursor ignoriert automatisch Dateien in .gitignore und in der folgenden Standard-Ausschlussliste. Du kannst das mit dem Präfix ! in .cursorignore überschreiben.

Einschränkungen bei Negationsmustern

Wenn du Negationsmuster (mit ! vorangestellt) verwendest, kannst du eine Datei nicht wieder einschließen, wenn ein übergeordnetes Verzeichnis per * ausgeschlossen wurde.
# Alle Dateien im public-Ordner ignorieren
public/*

# ✅ Das funktioniert, da die Datei auf der obersten Ebene liegt
!public/index.html

# ❌ Das funktioniert nicht – Dateien aus verschachtelten Verzeichnissen können nicht wieder eingeschlossen werden
!public/assets/style.css
Workaround: Verschachtelte Verzeichnisse explizit ausschließen:
public/assets/*
!public/assets/style.css # Diese Datei ist jetzt zugänglich
Ausgeschlossene Verzeichnisse werden aus Performancegründen nicht traversiert, daher haben Muster für enthaltene Dateien keine Wirkung. Das entspricht der .gitignore-Implementierung für Negationsmuster in verschachtelten Verzeichnissen. Weitere Details findest du in der offiziellen Git-Dokumentation zu gitignore-Mustern.

Fehlerbehebung

Teste Muster mit git check-ignore -v [file].