​
Überblick

Cursor liest und indexiert die Codebasis Ihres Projekts, um seine Funktionen zu unterstützen. Kontrollieren Sie, auf welche Verzeichnisse und Dateien Cursor zugreifen kann, indem Sie eine .cursorignore-Datei in Ihrem Stammverzeichnis verwenden. Cursor blockiert den Zugriff auf Dateien, die in .cursorignore aufgelistet sind, für:
Tool-Aufrufe, die vom Agent initiiert werden, wie Terminal und MCP-Server, können den Zugriff auf Code, der von .cursorignore verwaltet wird, nicht blockieren

​
Warum Dateien ignorieren?

Sicherheit: Beschränken Sie den Zugriff auf API-Schlüssel, Anmeldedaten und Geheimnisse. Obwohl Cursor ignorierte Dateien blockiert, ist ein vollständiger Schutz aufgrund der Unvorhersagbarkeit von LLMs nicht garantiert. Leistung: In großen Codebasen oder Monorepos schließen Sie irrelevante Bereiche aus, um eine schnellere Indizierung und genauere Dateierkennung zu ermöglichen.

​
Globale Ignore-Dateien

Legen Sie Ignore-Muster für alle Projekte in den Benutzereinstellungen fest, um sensible Dateien ohne projektspezifische Konfiguration auszuschließen.
Globale Cursor Ignore-Liste
Standardmuster umfassen:
  • Umgebungsdateien: **/.env, **/.env.*
  • Anmeldedaten: **/credentials.json, **/secrets.json
  • Schlüssel: **/*.key, **/*.pem, **/id_rsa

​
Konfiguration von .cursorignore

Erstellen Sie eine .cursorignore-Datei in Ihrem Stammverzeichnis mit der .gitignore-Syntax.

​
Musterbeispiele

config.json      # Spezifische Datei
dist/           # Verzeichnis
*.log           # Dateierweiterung
**/logs         # Verschachtelte Verzeichnisse
!app/           # Von Ignorierung ausschließen (negieren)

​
Hierarchisches Ignorieren

Aktivieren Sie Cursor Settings > Features > Editor > Hierarchical Cursor Ignore, um übergeordnete Verzeichnisse nach .cursorignore-Dateien zu durchsuchen. Hinweise: Kommentare beginnen mit #. Spätere Muster überschreiben frühere. Muster sind relativ zum Dateispeicherort.

​
Indexierung mit .cursorindexingignore begrenzen

Verwenden Sie .cursorindexingignore, um Dateien nur von der Indexierung auszuschließen. Diese Dateien bleiben für KI-Features zugänglich, erscheinen aber nicht in Codebase-Suchen.

​
Standardmäßig ignorierte Dateien

Cursor ignoriert automatisch Dateien in .gitignore und der unten stehenden Standard-Ignorierliste. Überschreiben Sie dies mit dem !-Präfix in .cursorignore.

​
Einschränkungen bei Negationsmustern

Bei der Verwendung von Negationsmustern (mit ! vorangestellt) können Sie eine Datei nicht wieder einschließen, wenn ein übergeordnetes Verzeichnis über * ausgeschlossen ist. 
# Alle Dateien im public-Ordner ignorieren
public/*

# ✅ Das funktioniert, da die Datei auf der obersten Ebene existiert
!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 Leistungsgründen nicht durchsucht, daher haben Muster für enthaltene Dateien keine Wirkung. Dies entspricht der .gitignore-Implementierung für Negationsmuster in verschachtelten Verzeichnissen. Weitere Details finden Sie in der offiziellen Git-Dokumentation zu gitignore-Mustern.

​
Fehlerbehebung

Testen Sie Muster mit git check-ignore -v [file].