Dateien ignorieren

Datei­zugriff mit .cursorignore und .cursorindexingignore steuern

Überblick

Cursor liest und indexiert den Code deiner Projektcodebasis, um seine Features bereitzustellen. Steuere, auf welche Verzeichnisse und Dateien Cursor zugreifen kann, indem du eine .cursorignore-Datei in deinem Projektwurzelverzeichnis verwendest.

Cursor blockiert den Zugriff auf in .cursorignore aufgeführte Dateien für:

• Codebase-Indexierung
• Code, auf den Tab, Agent und Inline Edit zugreifen können
• Code, der über @-Symbol-Referenzen zugänglich ist

Vom Agent initiierte Tool-Aufrufe, wie Terminal- und MCP-Server, können den Zugriff auf Code, der durch .cursorignore geregelt ist, nicht verhindern

Warum Dateien ignorieren?

Sicherheit: Den Zugriff auf API-Schlüssel, Zugangsdaten und Secrets einschränken. 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, damit das Indexieren schneller wird und Dateien genauer gefunden werden.

Globale Ignore-Dateien

Stell in den Benutzereinstellungen projektübergreifende Ignore-Muster ein, um sensible Dateien auszuschließen – ganz ohne separate Projektkonfiguration.

Standardmäßig enthalten:

• Umgebungsdateien: **/.env, **/.env.*
• Zugangsdaten: **/credentials.json, **/secrets.json
• Schlüssel: **/*.key, **/*.pem, **/id_rsa

Konfigurieren von .cursorignore

Erstell in deinem Root-Verzeichnis eine .cursorignore-Datei mit .gitignore-Syntax.

Musterbeispiele

config.json      # Konkrete Datei
dist/            # Verzeichnis
*.log            # Dateiendung
**/logs          # Verschachtelte Verzeichnisse
!app/            # Von der Ignorierliste ausnehmen (Negation)

Hierarchisches Ignorieren

Aktiviere 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 Speicherort der Datei.

Indexierung mit .cursorindexingignore einschränken

Verwende .cursorindexingignore, um Dateien ausschließlich 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 deiner .gitignore sowie in der untenstehenden Standard-Ignore-Liste. Du kannst das mit dem Präfix ! in .cursorignore überschreiben.

Standard-Ignore-Liste

Nur für die Indizierung werden diese Dateien zusätzlich zu den Dateien in deiner .gitignore, .cursorignore und .cursorindexingignore ignoriert:

package-lock.json
pnpm-lock.yaml
yarn.lock
composer.lock
Gemfile.lock
bun.lockb
.env*
.git/
.svn/
.hg/
*.lock
*.bak
*.tmp
*.bin
*.exe
*.dll
*.so
*.lockb
*.qwoff
*.isl
*.csv
*.pdf
*.doc
*.doc
*.xls
*.xlsx
*.ppt
*.pptx
*.odt
*.ods
*.odp
*.odg
*.odf
*.sxw
*.sxc
*.sxi
*.sxd
*.sdc
*.jpg
*.jpeg
*.png
*.gif
*.bmp
*.tif
*.mp3
*.wav
*.wma
*.ogg
*.flac
*.aac
*.mp4
*.mov
*.wmv
*.flv
*.avi
*.zip
*.tar
*.gz
*.7z
*.rar
*.tgz
*.dmg
*.iso
*.cue
*.mdf
*.mds
*.vcd
*.toast
*.img
*.apk
*.msi
*.cab
*.tar.gz
*.tar.xz
*.tar.bz2
*.tar.lzma
*.tar.Z
*.tar.sz
*.lzma
*.ttf
*.otf
*.pak
*.woff
*.woff2
*.eot
*.webp
*.vsix
*.rmeta
*.rlib
*.parquet
*.svg
.egg-info/
.venv/
node_modules/
__pycache__/
.next/
.nuxt/
.cache/
.sass-cache/
.gradle/
.DS_Store/
.ipynb_checkpoints/
.pytest_cache/
.mypy_cache/
.tox/
.git/
.hg/
.svn/
.bzr/
.lock-wscript/
.Python/
.jupyter/
.history/
.yarn/
.yarn-cache/
.eslintcache/
.parcel-cache/
.cache-loader/
.nyc_output/
.node_repl_history/
.pnp.js/
.pnp/

Einschränkungen von Negationsmustern

Wenn du Negationsmuster verwendest (mit ! vorangestellt), kannst du eine Datei nicht wieder einbeziehen, wenn ein übergeordnetes Verzeichnis per * ausgeschlossen wurde.

# Alle Dateien im Ordner public ignorieren
public/*

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

# ❌ Das funktioniert nicht – Dateien aus verschachtelten Verzeichnissen können nicht wieder einbezogen 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 Performance-Grü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].