Dans Cursor, .cursorignore et .cursorindexingignore se ressemblent, mais ils ne remplissent pas le même but. De nombreux grands dépôts mélangent les deux dès le départ, et le résultat est soit l’indexation, soit le triage, soit le blocage du code qui était initialement destiné à être vu par l’IA.
La différence la plus simple est que .cursorindexingignore n’affecte que l’index et n’affecte pas la plupart des lectures IA, tandis que .cursorignore est plus agressif, empêchant ces fichiers d’entrer dans l’index et affectant également les chemins d’accès tels que Tab, Agent, Inline Edit et références. C’est-à-dire que l’un concerne la performance et la recherche, l’autre le contrôle d’accès.
Si vous voulez rendre la recherche de la base de code plus propre et plus rapide parce que le monodépôt est trop volumineux, avec trop de produits de compilation et la documentation trop encombrée, utilisez d’abord .cursorindexingignore. Comme ces documents ne valent peut-être pas la peine d’être indexés, il ne faut pas forcément interdire complètement à l’IA de les consulter lorsque c’est nécessaire.
Inversement, si vous ne souhaitez pas explicitement que certains répertoires entrent dans le flux de travail de routine de l’IA, comme les identifiants, les configurations privées et les sous-projets superflus, alors .cursorignore est plus approprié. Il est écrit « ne laissez pas ce contenu entrer dans la surface principale d’accès de l’IA », pas seulement « ne pas les intégrer ».
Pourquoi tant de gens utilisent-ils l’inverse ? Parce que lorsque vous voyez « ignorer », vous comprendrez par défaut un sens. En conséquence, le problème de performance est traité comme un problème de sécurité, ou comme un problème d’index. Les conséquences typiques sont :
1. Utiliser .cursorignore pour bloquer un tas de grands annuaires que vous ne souhaitez pas indexer, ce qui donne une visibilité étroite lorsque l’IA répond.
2. N’écrire que .cursorindexingignore, pensant que les fichiers sensibles ont été bloqués, mais que l’IA réelle peut quand même les rencontrer par d’autres chemins.
En pratique, une division très utile est : spawn, cache, énormes journaux et packages de fournisseurs tiers, avec la priorité dans .cursorindexingignore ; Si vous ne voulez vraiment pas entrer le contenu dans le contexte IA classique, ajoutez .cursorignore. Après avoir écrit, va dans Cursor’s Indexing & Docs pour regarder les fichiers inclus, ou utilise git check-ignore pour vérifier les règles, ne te fie pas à des suppositions.
Ainsi, ces deux documents ne sont pas ceux qui remplacent qui, mais chacun a sa propre couche. Plus le grand dépôt est complexe, plus il devrait séparer « pour accélérer l’indexation » et « pour réduire l’accès aux tuyaux d’exposition » dès le départ. Je ne peux pas le dire clairement, et plus je l’améliore, plus ça devient chaotique.