Pentru ca simbolul `@codebase` să poată răspunde instantaneu la întrebări despre întregul proiect, Cursor construiește un index vectorial local pe calculatorul tău. Pe repositorii masive, indexarea tuturor fișierelor poate dura mult timp, poate consuma memorie RAM și poate introduce zgomot semantic irelevant.
Mai grav, dacă proiectul conține fișiere sensibile precum `.env`, dump-uri de baze de date cu date reale ale clienților sau chei private de criptare, acestea riscă să fie indexate și trimise în fragmentele de context către modelul AI.
Fișierul .cursorignore funcționează exact ca un `.gitignore`: el specifică clar directoarele și fișierele pe care motorul de indexare Cursor trebuie să le ignore complet, menținând căutarea rapidă, precisă și 100% securizată.
Sintaxă, opțiuni și concepte cheie
| Opțiune / Concept | Descriere practică |
|---|---|
.cursorignore |
Fișierul de excludere plasat în directorul principal al proiectului. |
Embeddings Cache |
Baza vectorială locală stocată pe disc ce accelerează căutarea semantică @codebase. |
Excluderi Standard |
Directoare care trebuie obligatoriu ignorate: `node_modules/`, `dist/`, `build/`, `*.log`, `.git/`. |
Resync Index |
Opțiunea din Cursor Settings de a șterge și reconstrui indexul după actualizarea regulilor de ignorare. |
Exemple practice de terminal și cod
Exemplul 1: Exemplu complet de fișier .cursorignore pentru un proiect enterprise
Protejarea secretelor și accelerarea căutării semantice.
# .cursorignore
# Secrete și variabile de mediu
.env
.env.*
*.pem
*.key
credentials.json
# Dependențe și build-uri masive
node_modules/
vendor/
.next/
dist/
build/
out/
# Baze de date locale și dump-uri
*.sqlite
*.sql
*.dump
data/raw/
# Fișiere de loguri și cache
logs/
*.log
.cache/
coverage/Rezultat & Impact
Indexare cu 80% mai rapidă și risc zero de scurgere a secretelor în prompturile AI.Greșeli frecvente și bune practici
- Presupunerea că `.gitignore` este suficient; Cursor citește `.gitignore`, dar adăugarea unui `.cursorignore` explicit este esențială pentru a exclude fișiere mari urmărite de git (cum ar fi mostrele de date).
- Ignorarea fișierelor de configurare TypeScript (`tsconfig.json`), ceea ce poate împiedica Cursor să înțeleagă alias-urile de import.