Ignorar archivos

Controla el acceso a archivos con .cursorignore y .cursorindexingignore

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 incluidos 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 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 monorepositorios, 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 ignorados para todos los proyectos en la configuración de usuario y así excluir archivos sensibles sin tener que configurarlo por proyecto.

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)

Ignorar jerárquico

Activa 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

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 código.

Archivos ignorados de forma predeterminada

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

Lista de ignorados predeterminada

Solo para indexación, estos archivos se ignoran además de los archivos en tu .gitignore, .cursorignore y .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/

Limitaciones de los patrones de negación

Al usar patrones de negación (con el prefijo !), no puedes volver a incluir un archivo si un directorio padre está excluido mediante *.

# Ignora todos los archivos de la carpeta public
public/*

# ✅ Esto funciona, porque el archivo está en el nivel superior
!public/index.html

# ❌ Esto no funciona: no puedes 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 los patrones de gitignore.

Solución de problemas

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