​
Genel Bakış

Cursor, özelliklerini desteklemek için projenizin kod tabanını okur ve indeksler. Cursor’ın hangi dizinlere ve dosyalara erişebileceğini, kök dizininizde bir .cursorignore dosyası kullanarak kontrol edin. Cursor, .cursorignore dosyasında listelenen dosyalara şu alanlardan erişimi engeller:
Agent tarafından başlatılan araç çağrıları, terminal ve MCP sunucuları gibi, .cursorignore tarafından yönetilen koda erişimi engelleyemez

​
Neden dosyaları yok saymalı?

Güvenlik: API anahtarları, kimlik bilgileri ve gizli bilgilere erişimi kısıtlayın. Cursor yok sayılan dosyaları engellese de, LLM’lerin öngörülemezliği nedeniyle tam koruma garanti edilmez. Performans: Büyük kod tabanlarında veya monorepo’larda, daha hızlı indeksleme ve daha doğru dosya keşfi için alakasız bölümleri hariç tutun.

​
Global ignore dosyaları

Hassas dosyaları proje başına yapılandırma gerektirmeden hariç tutmak için kullanıcı ayarlarında tüm projeler için ignore kalıpları ayarlayın.
Global Cursor Ignore List
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ırması

.gitignore sözdizimini kullanarak kök dizininizde bir .cursorignore dosyası oluşturun.

​
Desen örnekleri

config.json      # Belirli dosya
dist/           # Dizin
*.log           # Dosya uzantısı
**/logs         # İç içe dizinler
!app/           # Yok sayma işleminden hariç tut (olumsuzlama)

​
Hiyerarşik yok sayma

.cursorignore dosyaları için üst dizinleri aramak üzere Cursor Settings > Features > Editor > Hierarchical Cursor Ignore seçeneğini etkinleştirin. Notlar: Yorumlar # ile başlar. Sonraki desenler önceki olanları geçersiz kılar. Desenler dosya konumuna göre görecelidir.

​
.cursorindexingignore ile indekslemeyi sınırlandırın

Dosyaları yalnızca indekslemeden hariç tutmak için .cursorindexingignore kullanın. Bu dosyalar AI özelliklerine erişilebilir kalır ancak kod tabanı aramalarında görünmez.

​
Varsayılan olarak yoksayılan dosyalar

Cursor, .gitignore dosyasındaki ve aşağıdaki varsayılan yoksayma listesindeki dosyaları otomatik olarak yoksayar. .cursorignore dosyasında ! öneki ile geçersiz kılabilirsiniz.

​
Olumsuzlama deseni sınırlamaları

Olumsuzlama desenlerini (! öneki ile) kullanırken, bir üst dizin * ile hariç tutulmuşsa bir dosyayı yeniden dahil edemezsiniz. 
# public klasöründeki tüm dosyaları yoksay
public/*

# ✅ Bu çalışır, çünkü dosya üst seviyede bulunur
!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ç tutun: 
public/assets/*
!public/assets/style.css # Bu dosya artık erişilebilir
Hariç tutulan dizinler performans için taranmaz, bu nedenle içerdikleri dosyalar üzerindeki desenler etkisizdir. Bu, iç içe dizinlerdeki olumsuzlama desenleri için .gitignore uygulamasıyla eşleşir. Daha fazla ayrıntı için gitignore desenleri hakkındaki resmi Git belgelerine bakın.

​
Sorun Giderme

git check-ignore -v [file] ile desenleri test edin.