`.cursorignore (fișierele ignorate de Cursor)` în Cursor IDE

Configurare, Depanare și Securitate Cursor (2026)

.cursorignore blochează accesul Agent, Tab și al mențiunilor @ la fișierele listate; Cursor respectă și .gitignore și o listă implicită de excluderi.

Sintaxă & invocare

.cursorignore în rădăcina proiectului (sintaxa .gitignore)

Ce face `.cursorignore (fișierele ignorate de Cursor)`

Fișierul .cursorignore din rădăcina proiectului folosește sintaxa .gitignore. Fișierele potrivite sunt blocate pentru Agent, pentru Tab și pentru mențiunile @. Terminalul și uneltele MCP folosite de Agent nu pot bloca accesul la ele, iar documentația avertizează că protecția nu este garantată complet, din cauza imprevizibilității modelelor.

Cursor ignoră deja fișierele din .gitignore și o listă implicită: fișiere lock (package-lock.json, yarn.lock, *.lock), .env*, .git/, node_modules/, imagini, arhive, fonturi, documente Office și altele. Un tipar cu ! în .cursorignore anulează o excludere. Ca la git, nu poți reinclude un fișier dintr-un director exclus cu *; exclude explicit subdirectorul, apoi reinclude fișierul.

În setările utilizatorului poți defini tipare globale pentru toate proiectele (lista e goală implicit). Cursor Settings > Indexing > Ignore Files > Hierarchical Cursor Ignore caută fișiere .cursorignore și în directoarele părinte. Căutarea Agent (Instant Grep) folosește un index local; documentația spune că nu se stochează embeddings ale codului pentru căutare.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
`*`	Orice caractere, fără `/`.
`**`	Orice caractere, inclusiv `/`.
`?`	Un singur caracter.
`!`	Anulează o excludere.
`#`	Comentariu.
`Hierarchical Cursor Ignore`	Caută `.cursorignore` și în directoarele părinte.

Exemple practice

Exemplul 1: .cursorignore pentru un proiect web

# secrete
**/*.pem
**/*.key
credentials.json

# build
dist/
coverage/
*.min.js

Exemplul 2: Reincluderea unui fișier dintr-un director exclus

public/assets/*
!public/assets/style.css

Exemplul 3: Testarea unui tipar

git check-ignore -v config.json

Greșeli frecvente și bune practici

Crezi că .cursorignore ascunde fișierele și de comenzile din terminal. Terminalul și uneltele MCP le pot citi.
Reincluzi un fișier cu public/* și !public/assets/style.css. Nu merge; exclude întâi public/assets/*.
Adaugi node_modules/ sau .env în .cursorignore. Sunt deja în lista implicită.

Ce face .cursorignore (fișierele ignorate de Cursor)