Vue d’ensemble
.cursorignore
à la racine de ton projet.
Cursor bloque l’accès aux fichiers listés dans .cursorignore
pour :
- L’indexation du codebase
- Le code accessible via Tab, Agent et Inline Edit
- Le code accessible via les références avec le symbole @
Les appels d’outils lancés par Agent, comme le terminal et les serveurs MCP, ne peuvent pas bloquer
l’accès au code régi par
.cursorignore
Pourquoi ignorer des fichiers ?
Fichiers d’ignore globaux

- Fichiers d’environnement :
**/.env
,**/.env.*
- Identifiants :
**/credentials.json
,**/secrets.json
- Clés :
**/*.key
,**/*.pem
,**/id_rsa
Configurer .cursorignore
.cursorignore
à la racine de ton projet en utilisant la syntaxe de .gitignore
.
Exemples de modèles
Ignorer hiérarchique
Cursor Settings
> Features
> Editor
> Hierarchical Cursor Ignore
pour rechercher des fichiers .cursorignore
dans les répertoires parents.
Notes : Les commentaires commencent par #
. Les règles définies plus tard écrasent les précédentes. Les règles sont relatives à l’emplacement du fichier.
Limiter l’indexation avec .cursorindexingignore
.cursorindexingignore
pour exclure des fichiers de l’indexation uniquement. Ces fichiers restent accessibles aux fonctionnalités d’IA, mais n’apparaîtront pas dans les recherches du codebase.
Fichiers ignorés par défaut
.gitignore
ainsi que la liste d’exclusion par défaut ci-dessous. Tu peux les rétablir avec le préfixe !
dans .cursorignore
.
Liste d’exclusion par défaut
Liste d’exclusion par défaut
Uniquement pour l’indexation, ces fichiers sont ignorés en plus de ceux présents dans ton
.gitignore
, .cursorignore
et .cursorindexingignore
:Limitations des motifs de négation
!
), tu ne peux pas réinclure un fichier si un répertoire parent est exclu via *.
Dépannage
git check-ignore -v [file]
.