Aperçu

Cursor lit et indexe le code de ton projet pour alimenter ses fonctionnalités. Contrôle à quels répertoires et fichiers Cursor peut accéder en utilisant un fichier .cursorignore à la racine du projet. Cursor bloque l’accès aux fichiers répertoriés dans .cursorignore pour :
Les appels d’outils initiés par Agent, comme le terminal et les serveurs MCP, ne peuvent pas empêcher l’accès au code régi par .cursorignore

Pourquoi ignorer des fichiers ?

Sécurité : Restreins l’accès aux clés API, identifiants et secrets. Même si Cursor bloque les fichiers ignorés, une protection totale n’est pas garantie à cause de l’imprévisibilité des LLM. Performance : Dans de grands codebases ou des monorepos, exclue les parties non pertinentes pour un indexage plus rapide et une détection de fichiers plus précise.

Fichiers d’ignore globaux

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

Configuration de .cursorignore

Crée un fichier .cursorignore à la racine de ton projet en utilisant la syntaxe .gitignore.

Exemples de modèles

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

Ignorer de manière hiérarchique

Active Cursor Settings > Features > Editor > Hierarchical Cursor Ignore pour rechercher des fichiers .cursorignore dans les répertoires parents. Notes : Les commentaires commencent par #. Les modèles définis plus tard prévalent sur les précédents. Les modèles sont relatifs à l’emplacement du fichier.

Limiter l’indexation avec .cursorindexingignore

Utilise .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 de la base de code.

Fichiers ignorés par défaut

Cursor ignore automatiquement les fichiers de .gitignore et la liste d’exclusions par défaut ci-dessous. Pour passer outre, utilise le préfixe ! dans .cursorignore.

Limites des motifs de négation

Quand tu utilises des motifs de négation (préfixés par !), tu ne peux pas réinclure un fichier si un répertoire parent est exclu via *.
# Ignorer tous les fichiers dans le dossier public
public/*

# ✅ Ça marche, car le fichier est à la racine
!public/index.html

# ❌ Ça ne marche pas : impossible de réinclure des fichiers depuis des sous-répertoires
!public/assets/style.css
Astuce : exclure explicitement les sous-répertoires :
public/assets/*
!public/assets/style.css # Ce fichier est maintenant accessible
Les répertoires exclus ne sont pas parcourus pour des raisons de perfs, donc les motifs visant les fichiers qu’ils contiennent n’ont aucun effet. Ça correspond au fonctionnement de .gitignore pour les motifs de négation dans les répertoires imbriqués. Pour plus de détails, consulte la doc officielle de Git sur les motifs gitignore.

Dépannage

Teste des motifs avec git check-ignore -v [file].