Ignorer des fichiers

Contrôle l’accès aux fichiers avec .cursorignore et .cursorindexingignore

Vue d’ensemble

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.

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 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 d’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 grandes bases de code ou des monorepos, exclue les parties non pertinentes pour un indexage plus rapide et une découverte de fichiers plus précise.

Fichiers d’ignorance globaux

Définis des modèles d’ignorance pour tous les projets dans les paramètres utilisateur afin d’exclure des fichiers sensibles sans configuration spécifique à chaque projet.

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ée un fichier .cursorignore à la racine de ton dépôt en utilisant la syntaxe de .gitignore.

Exemples de motifs

config.json      # Fichier spécifique
dist/            # Dossier
*.log            # Extension de fichier
**/logs          # Dossiers imbriqués
!app/            # Annuler l’ignorance (négation)

Ignorance hiérarchique

Active Cursor Settings > Features > Editor > Hierarchical Cursor Ignore pour chercher les fichiers .cursorignore dans les répertoires parents.

Notes : les commentaires commencent par #. Les motifs définis plus tard remplacent les précédents. Les motifs 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 listés dans .gitignore ainsi que ceux de la liste d’exclusion par défaut ci-dessous. Pour passer outre, utilise le préfixe ! dans .cursorignore.

Liste d’exclusion par défaut

Uniquement pour l’indexation, ces fichiers sont ignorés en plus de ceux présents dans tes .gitignore, .cursorignore et .cursorindexingignore :

package-lock.json
pnpm-lock.yaml
yarn.lock
composer.lock
Gemfile.lock
bun.lockb
.env*
.git/
.svn/
.hg/
*.lock
*.bak
*.tmp
*.bin
*.exe
*.dll
*.so
*.lockb
*.qwoff
*.isl
*.csv
*.pdf
*.doc
*.doc
*.xls
*.xlsx
*.ppt
*.pptx
*.odt
*.ods
*.odp
*.odg
*.odf
*.sxw
*.sxc
*.sxi
*.sxd
*.sdc
*.jpg
*.jpeg
*.png
*.gif
*.bmp
*.tif
*.mp3
*.wav
*.wma
*.ogg
*.flac
*.aac
*.mp4
*.mov
*.wmv
*.flv
*.avi
*.zip
*.tar
*.gz
*.7z
*.rar
*.tgz
*.dmg
*.iso
*.cue
*.mdf
*.mds
*.vcd
*.toast
*.img
*.apk
*.msi
*.cab
*.tar.gz
*.tar.xz
*.tar.bz2
*.tar.lzma
*.tar.Z
*.tar.sz
*.lzma
*.ttf
*.otf
*.pak
*.woff
*.woff2
*.eot
*.webp
*.vsix
*.rmeta
*.rlib
*.parquet
*.svg
.egg-info/
.venv/
node_modules/
__pycache__/
.next/
.nuxt/
.cache/
.sass-cache/
.gradle/
.DS_Store/
.ipynb_checkpoints/
.pytest_cache/
.mypy_cache/
.tox/
.git/
.hg/
.svn/
.bzr/
.lock-wscript/
.Python/
.jupyter/
.history/
.yarn/
.yarn-cache/
.eslintcache/
.parcel-cache/
.cache-loader/
.nyc_output/
.node_repl_history/
.pnp.js/
.pnp/

Limitations 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 du 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 répertoires imbriqués
!public/assets/style.css

Contournement : exclure explicitement les répertoires imbriqués :

public/assets/*
!public/assets/style.css # Ce fichier est maintenant pris en compte

Les répertoires exclus ne sont pas parcourus pour des raisons de performances, donc les motifs sur les fichiers qu’ils contiennent n’ont aucun effet. Ça correspond à l’implémentation de .gitignore pour les motifs de négation dans les répertoires imbriqués. Pour plus de détails, consulte la documentation officielle de Git sur les motifs gitignore.

Dépannage

Teste les modèles avec git check-ignore -v [file].