Descripción general

Cursor lee e indexa el código de tu proyecto para potenciar sus funciones. Controla a 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 para:
Las llamadas a herramientas iniciadas por Agent, como el terminal y los 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, no se puede garantizar una protección total debido a la imprevisibilidad de los LLM. Rendimiento: En bases de código grandes o monorepos, excluye partes irrelevantes para un indexado más rápido y una detección de archivos más precisa.

Archivos de ignorados globales

Define patrones de ignorado para todos los proyectos en la configuración de usuario y así excluir archivos sensibles sin tener que configurarlo por proyecto.
Lista global de ignorados de Cursor
Los patrones predeterminados incluyen:
  • Archivos de entorno: **/.env, **/.env.*
  • Credenciales: **/credentials.json, **/secrets.json
  • Claves: **/*.key, **/*.pem, **/id_rsa

Configuración de .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 la lista de ignorados (negación)

Ignorado jerárquico

Activa Cursor Settings > Features > Editor > Hierarchical Cursor Ignore para buscar archivos .cursorignore en los directorios superiores. Notas: Los comentarios empiezan con #. Los patrones posteriores prevalecen sobre los anteriores. Los patrones son relativos a la ubicación del archivo.

Limita la indexación con .cursorindexingignore

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

Archivos ignorados por defecto

Cursor ignora automáticamente los archivos en .gitignore y la lista de ignorados predeterminada de abajo. Puedes anular esto con el prefijo ! en .cursorignore.

Limitaciones de los patrones de negación

Cuando uses patrones de negación (con prefijo !), no puedes volver a incluir un archivo si un directorio padre está excluido mediante *.
# Ignora 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: Excluye explícitamente los directorios anidados:
public/assets/*
!public/assets/style.css # Este archivo ahora es accesible
Los directorios excluidos no se recorren por motivos de rendimiento, así que los patrones sobre los 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 de gitignore.

Solución de problemas

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