​
Aperçu

Cursor lit et indexe la base de code de votre projet pour alimenter ses fonctionnalités. Contrôlez quels répertoires et fichiers Cursor peut accéder en utilisant un fichier .cursorignore dans votre répertoire racine. Cursor bloque l’accès aux fichiers listés dans .cursorignore pour :
Les appels d’outils initié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 ?

Sécurité : Restreindre l’accès aux clés API, identifiants et secrets. Bien que Cursor bloque les fichiers ignorés, une protection complète n’est pas garantie en raison de l’imprévisibilité des LLM. Performance : Dans les grandes bases de code ou les monorepos, exclure les portions non pertinentes pour une indexation plus rapide et une découverte de fichiers plus précise.

​
Fichiers d’exclusion globaux

Définissez des modèles d’exclusion pour tous les projets dans les paramètres utilisateur afin d’exclure les fichiers sensibles sans configuration par projet.
Liste d'exclusion globale de Cursor
Les modèles par défaut incluent :
  • Fichiers d’environnement : **/.env, **/.env.*
  • Identifiants : **/credentials.json, **/secrets.json
  • Clés : **/*.key, **/*.pem, **/id_rsa

​
Configuration de .cursorignore

Créez un fichier .cursorignore dans votre répertoire racine en utilisant la syntaxe .gitignore.

​
Exemples de motifs

config.json      # Fichier spécifique
dist/           # Répertoire
*.log           # Extension de fichier
**/logs         # Répertoires imbriqués
!app/           # Exclure de l'ignore (négation)

​
Ignore hiérarchique

Activez Cursor Settings > Features > Editor > Hierarchical Cursor Ignore pour rechercher les fichiers .cursorignore dans les répertoires parents. Notes : Les commentaires commencent par #. Les motifs ultérieurs remplacent les précédents. Les motifs sont relatifs à l’emplacement du fichier.

​
Limiter l’indexation avec .cursorindexingignore

Utilisez .cursorindexingignore pour exclure des fichiers de l’indexation uniquement. Ces fichiers restent accessibles aux fonctionnalités IA mais n’apparaîtront pas dans les recherches de base de code.

​
Fichiers ignorés par défaut

Cursor ignore automatiquement les fichiers dans .gitignore et la liste d’exclusion par défaut ci-dessous. Remplacez avec le préfixe ! dans .cursorignore.

​
Limitations des motifs de négation

Lors de l’utilisation de motifs de négation (préfixés par !), vous ne pouvez pas ré-inclure un fichier si un répertoire parent est exclu via *. 
# Ignorer tous les fichiers dans le dossier public
public/*

# ✅ Ceci fonctionne, car le fichier existe au niveau supérieur
!public/index.html

# ❌ Ceci ne fonctionne pas - impossible de ré-inclure des fichiers de répertoires imbriqués
!public/assets/style.css
Solution de contournement : Excluez explicitement les répertoires imbriqués : 
public/assets/*
!public/assets/style.css # Ce fichier est maintenant accessible
Les répertoires exclus ne sont pas parcourus pour des raisons de performance, donc les motifs sur les fichiers contenus n’ont aucun effet. Ceci correspond à l’implémentation .gitignore pour les motifs de négation dans les répertoires imbriqués. Pour plus de détails, consultez la documentation officielle Git sur les motifs gitignore.

​
Dépannage

Testez les motifs avec git check-ignore -v [file].