​
Descripción general

Cursor lee e indexa la base de código de tu proyecto para potenciar sus funciones. Controla qué directorios y archivos puede acceder Cursor usando un archivo .cursorignore en tu directorio raíz. Cursor bloquea el acceso a los archivos listados en .cursorignore desde:
Las llamadas de herramientas iniciadas por Agent, como terminal y servidores MCP, no pueden bloquear el acceso al código regido por .cursorignore

​
¿Por qué ignorar archivos?

Seguridad: Restringe el acceso a claves de API, credenciales y secretos. Aunque Cursor bloquea los archivos ignorados, la protección completa no está garantizada debido a la impredecibilidad de los LLM. Rendimiento: En bases de código grandes o monorepos, excluye porciones irrelevantes para un indexado más rápido y un descubrimiento de archivos más preciso.

​
Archivos de ignorar globales

Establece patrones de ignorar para todos los proyectos en la configuración de usuario para excluir archivos sensibles sin configuración por proyecto.
Lista Global de Ignorar de Cursor
Los patrones predeterminados incluyen:
  • Archivos de entorno: **/.env, **/.env.*
  • Credenciales: **/credentials.json, **/secrets.json
  • Claves: **/*.key, **/*.pem, **/id_rsa

​
Configurando .cursorignore

Crea un archivo .cursorignore en tu directorio raíz usando la sintaxis de .gitignore.

​
Ejemplos de patrones

config.json      # Archivo específico
dist/           # Directorio
*.log           # Extensión de archivo
**/logs         # Directorios anidados
!app/           # Excluir de ignorar (negar)

​
Ignorar jerárquico

Habilita Cursor Settings > Features > Editor > Hierarchical Cursor Ignore para buscar archivos .cursorignore en directorios padre. Notas: Los comentarios comienzan con #. Los patrones posteriores anulan los anteriores. Los patrones son relativos a la ubicación del archivo.

​
Limitar la indexación con .cursorindexingignore

Usa .cursorindexingignore para excluir archivos únicamente de la indexación. Estos archivos permanecen accesibles para las funciones de IA pero no aparecerán en las búsquedas del código base.

​
Archivos ignorados por defecto

Cursor ignora automáticamente los archivos en .gitignore y la lista de ignorados por defecto que se muestra a continuación. Puedes anular esto con el prefijo ! en .cursorignore.

​
Limitaciones de patrones de negación

Al usar patrones de negación (con prefijo !), no puedes volver a incluir un archivo si un directorio padre está excluido mediante *. 
# Ignorar todos los archivos en la carpeta public
public/*

# ✅ Esto funciona, ya que el archivo existe en el nivel superior
!public/index.html

# ❌ Esto no funciona - no se pueden volver a incluir archivos de directorios anidados
!public/assets/style.css
Solución alternativa: Excluir explícitamente los directorios anidados: 
public/assets/*
!public/assets/style.css # Este archivo ahora es accesible
Los directorios excluidos no se recorren por rendimiento, por lo que los patrones en archivos contenidos no tienen efecto. Esto coincide con la implementación de .gitignore para patrones de negación en directorios anidados. Para más detalles, consulta la documentación oficial de Git sobre patrones gitignore.

​
Solución de problemas

Prueba patrones con git check-ignore -v [file].