​
Gambaran Umum

Cursor membaca dan mengindeks basis kode proyek Anda untuk mendukung fitur-fiturnya. Kontrol direktori dan file mana yang dapat diakses Cursor menggunakan file .cursorignore di direktori root Anda. Cursor memblokir akses ke file yang terdaftar di .cursorignore dari:
Panggilan tool yang diprakarsai oleh Agent, seperti terminal dan server MCP, tidak dapat memblokir akses ke kode yang diatur oleh .cursorignore

​
Mengapa mengabaikan file?

Keamanan: Membatasi akses ke API key, kredensial, dan rahasia. Meskipun Cursor memblokir file yang diabaikan, perlindungan lengkap tidak dijamin karena ketidakpastian LLM. Performa: Dalam basis kode yang besar atau monorepo, kecualikan bagian yang tidak relevan untuk pengindeksan yang lebih cepat dan penemuan file yang lebih akurat.

​
File ignore global

Atur pola ignore untuk semua proyek dalam pengaturan pengguna untuk mengecualikan file sensitif tanpa konfigurasi per-proyek.
Daftar Global Cursor Ignore
Pola default meliputi:
  • File environment: **/.env, **/.env.*
  • Kredensial: **/credentials.json, **/secrets.json
  • Kunci: **/*.key, **/*.pem, **/id_rsa

​
Mengonfigurasi .cursorignore

Buat file .cursorignore di direktori root Anda menggunakan sintaks .gitignore.

​
Contoh pola

config.json      # File spesifik
dist/           # Direktori
*.log           # Ekstensi file
**/logs         # Direktori bersarang
!app/           # Kecualikan dari ignore (negasi)

​
Ignore hierarkis

Aktifkan Cursor Settings > Features > Editor > Hierarchical Cursor Ignore untuk mencari file .cursorignore di direktori induk. Catatan: Komentar dimulai dengan #. Pola yang lebih belakang menimpa pola sebelumnya. Pola relatif terhadap lokasi file.

​
Batasi pengindeksan dengan .cursorindexingignore

Gunakan .cursorindexingignore untuk mengecualikan file dari pengindeksan saja. File-file ini tetap dapat diakses oleh fitur AI tetapi tidak akan muncul dalam pencarian codebase.

​
File yang diabaikan secara default

Cursor secara otomatis mengabaikan file dalam .gitignore dan daftar ignore default di bawah ini. Timpa dengan awalan ! di .cursorignore.

​
Keterbatasan pola negasi

Saat menggunakan pola negasi (diawali dengan !), Anda tidak dapat menyertakan kembali file jika direktori induk dikecualikan melalui *. 
# Abaikan semua file dalam folder public
public/*

# ✅ Ini berfungsi, karena file ada di tingkat teratas
!public/index.html

# ❌ Ini tidak berfungsi - tidak dapat menyertakan kembali file dari direktori bersarang
!public/assets/style.css
Solusi: Kecualikan direktori bersarang secara eksplisit: 
public/assets/*
!public/assets/style.css # File ini sekarang dapat diakses
Direktori yang dikecualikan tidak dijelajahi untuk performa, sehingga pola pada file yang terkandung tidak berpengaruh. Ini sesuai dengan implementasi .gitignore untuk pola negasi dalam direktori bersarang. Untuk detail lebih lanjut, lihat dokumentasi resmi Git tentang pola gitignore.

​
Pemecahan Masalah

Uji pola dengan git check-ignore -v [file].