Descripción general
.cursorignore
en tu directorio raíz.
Cursor bloquea el acceso a los archivos listados en .cursorignore
para:
- Indexación del código base
- Código accesible por Tab, Agent y Inline Edit
- Código accesible mediante referencias con el símbolo @
Las llamadas a herramientas iniciadas por Agent, como la terminal y los servidores MCP, no pueden bloquear
el acceso al código gobernado por
.cursorignore
¿Por qué ignorar archivos?
Archivos globales de ignore

- Archivos de entorno:
**/.env
,**/.env.*
- Credenciales:
**/credentials.json
,**/secrets.json
- Claves:
**/*.key
,**/*.pem
,**/id_rsa
Configurar .cursorignore
.cursorignore
en tu directorio raíz usando la sintaxis de .gitignore
.
Ejemplos de patrones
Ignorar jerárquico
Cursor Settings
> Features
> Editor
> Hierarchical Cursor Ignore
para buscar en los directorios superiores archivos .cursorignore
.
Notas: Los comentarios empiezan con #
. Los patrones posteriores reemplazan a los anteriores. Los patrones son relativos a la ubicación del archivo.
Limita la indexación con .cursorindexingignore
.cursorindexingignore
para excluir archivos únicamente de la indexación. Estos archivos siguen estando disponibles para las funciones de IA, pero no aparecerán en las búsquedas del código.
Archivos ignorados de forma predeterminada
.gitignore
y la lista de ignorados predeterminada de abajo. Podés anular esto con el prefijo !
en .cursorignore
.
Lista de ignorados predeterminada
Lista de ignorados predeterminada
Solo para indexación, estos archivos se ignoran además de los que estén en tu
.gitignore
, .cursorignore
y .cursorindexingignore
:Limitaciones de los patrones de negación
!
), no podés volver a incluir un archivo si un directorio padre está excluido mediante *
.
Solución de problemas
git check-ignore -v [file]
.