Dosyaları yoksay

.cursorignore ve .cursorindexingignore ile dosya erişimini kontrol et

Genel Bakış

Cursor, özelliklerini çalıştırmak için projenin kod tabanını okur ve indeksler. Kök dizinindeki .cursorignore dosyasını kullanarak Cursor’ın hangi dizin ve dosyalara erişebileceğini kontrol et.

Cursor, .cursorignore içinde listelenen dosyalara erişimi şuralarda engeller:

• Kod tabanı indeksleme
• Tab, Agent ve Inline Edit tarafından erişilebilen kod
• @ sembol referansları aracılığıyla erişilebilen kod

Agent tarafından başlatılan araç çağrıları (ör. terminal ve MCP sunucuları), .cursorignore kapsamındaki koda erişimi engelleyemez

Dosyalar neden yok sayılır?

Güvenlik: API anahtarlarına, kimlik bilgilerine ve sırlarına erişimi kısıtla. Cursor yok sayılan dosyaları engellese de LLM’lerin öngörülemezliği nedeniyle tam koruma garanti edilemez.

Performans: Büyük kod tabanlarında veya monorepolarda, daha hızlı indeksleme ve daha isabetli dosya bulma için alakasız kısımları dışarıda bırak.

Global ignore dosyaları

Her proje için ayrı ayrı ayar yapmadan hassas dosyaları hariç tutmak üzere, kullanıcı ayarlarında tüm projeler için ignore kalıpları tanımla.

Varsayılan kalıplar şunları içerir:

• Ortam dosyaları: **/.env, **/.env.*
• Kimlik bilgileri: **/credentials.json, **/secrets.json
• Anahtarlar: **/*.key, **/*.pem, **/id_rsa

.cursorignore yapılandırma

Kök dizininde .gitignore söz dizimini kullanarak bir .cursorignore dosyası oluştur.

Desen örnekleri

config.json      # Belirli dosya
dist/            # Dizin
*.log            # Dosya uzantısı
**/logs          # İç içe dizinler
!app/            # Yoksayımdan çıkar (negasyon)

Hiyerarşik yok sayma

Üst dizinlerde .cursorignore dosyalarını aramak için Cursor Settings > Features > Editor > Hierarchical Cursor Ignore özelliğini etkinleştir.

Notlar: Yorumlar # ile başlar. Sonraki kalıplar önceki kalıpların üzerine yazar. Kalıplar dosyanın konumuna göre görecelidir.

.cursorindexingignore ile indekslemeyi sınırla

Yalnızca indekslemeden dosyaları hariç tutmak için .cursorindexingignore kullan. Bu dosyalar AI özelliklerince erişilebilir kalır ama kod tabanı aramalarında görünmez.

Varsayılan olarak yok sayılan dosyalar

Cursor, .gitignore ve aşağıdaki varsayılan yok sayma listesindeki dosyaları otomatik olarak yok sayar. .cursorignore içinde ! önekiyle bunu geçersiz kılabilirsin.

Varsayılan Yok Sayma Listesi

Yalnızca indeksleme için, .gitignore, .cursorignore ve .cursorindexingignore içindekilere ek olarak şu dosyalar yok sayılır:

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/

Olumsuzlama desenlerinin sınırlamaları

Olumsuzlama desenlerini (! ile başlayan) kullanırken, bir üst dizin * ile hariç tutulduysa bir dosyayı yeniden dahil edemezsin.

# public klasöründeki tüm dosyaları yok say
public/*

# ✅ Bu çalışır, çünkü dosya en üst düzeyde
!public/index.html

# ❌ Bu çalışmaz — iç içe dizinlerden dosyalar yeniden dahil edilemez
!public/assets/style.css

Geçici çözüm: İç içe dizinleri açıkça hariç tut:

public/assets/*
!public/assets/style.css # Bu dosyaya artık erişebilirsin

Performans için hariç tutulan dizinler taranmaz, bu nedenle içlerindeki dosyalar için yazdığın desenlerin etkisi olmaz. Bu davranış, iç içe dizinlerdeki olumsuzlama desenleri için .gitignore uygulamasıyla aynıdır. Daha fazla bilgi için gitignore desenleriyle ilgili resmi Git belgelerine bak.

Sorun Giderme

Desenleri git check-ignore -v [file] komutuyla test et.