Genel Bakış

Cursor, özelliklerini çalıştırmak için projenin kod tabanını okur ve indeksler. Kök dizindeki .cursorignore dosyasını kullanarak Cursor’ın hangi dizin ve dosyalara erişebileceğini kontrol et. Cursor, .cursorignore içinde listelenen dosyalara erişimi şuralardan engeller:
Agent tarafından başlatılan terminal ve MCP sunucuları gibi araç çağrıları, .cursorignore kapsamındaki koda erişimi engelleyemez

Neden dosyaları yok sayasın?

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ı hariç tut.

Global ignore dosyaları

Kullanıcı ayarlarında tüm projeler için ignore desenleri belirleyerek, proje bazında ek yapılandırmaya gerek kalmadan hassas dosyaları dışarıda tut.
Global Cursor Ignore List
Varsayılan desenler ş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özdizimini kullanarak bir .cursorignore dosyası oluştur.

Desen örnekleri

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

Hiyerarşik yoksayma

Üst dizinlerde .cursorignore dosyalarını aramak için Cursor Settings > Features > Editor > Hierarchical Cursor Ignore seçeneğini etkinleştir. Notlar: Yorumlar # ile başlar. Sonraki desenler öncekileri geçersiz kılar. Desenler dosyanın konumuna göredir.

Dizinlemeyi .cursorindexingignore ile sınırla

Yalnızca dizine eklemeden dosyaları hariç tutmak için .cursorindexingignore kullan. Bu dosyalar AI özellikleri tarafından erişilebilir olmaya devam eder 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 ! öneki kullanarak geçersiz kılabilirsin.

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 edemezsin
!public/assets/style.css
Geçici çözüm: İç içe dizinleri açıkça hariç tut:
public/assets/*
!public/assets/style.css # Bu dosya artık erişilebilir
Hariç tutulan dizinler performans için taranmaz; bu yüzden içlerindeki dosyalarla ilgili desenlerin etkisi olmaz. Bu, iç içe dizinlerdeki olumsuzlama desenleri için .gitignore davranışıyla aynıdır. Daha fazla bilgi için gitignore desenlerine ilişkin resmi Git dokümantasyonuna bak.

Sorun giderme

Test kalıplarını git check-ignore -v [file] ile dene.