Файл игнорирования

Cursor читает кодовую базу вашего проекта для работы своих функций. С помощью файла .cursorignore в корневом каталоге можно указать, к каким каталогам и файлам Cursor имеет доступ.

Cursor блокирует доступ к файлам, перечисленным в .cursorignore, для:

• Кода, доступного через Agent, Tab и Inline Edit
• Кода, доступного через ссылки @-упоминаний

Зачем игнорировать файлы?

Безопасность: Ограничьте доступ к API-ключам, учётным данным и секретам. Хотя Cursor блокирует игнорируемые файлы, полная защита не гарантирована из-за непредсказуемости LLM.

Производительность: В больших кодовых базах и монорепозиториях исключайте нерелевантные части для более точного поиска файлов.

Настройка .cursorignore

Создайте файл .cursorignore в корневом каталоге с синтаксисом .gitignore.

Синтаксис шаблонов

• * соответствует любым символам, кроме /
• ** соответствует любым символам, включая /
• ? соответствует одному символу
• ! отменяет игнорирование по шаблону (включает ранее проигнорированный путь)
• Строки, начинающиеся с #, являются комментариями
• Пробелы в конце строки игнорируются, если перед ними нет \

Примеры шаблонов

config.json      # Конкретный файлdist/           # Каталог*.log           # Расширение файла**/logs         # Вложенные каталоги!app/           # Исключить из игнорирования (отрицание)

Иерархическое игнорирование

Включите Cursor Settings > Features > Editor > Hierarchical Cursor Ignore, чтобы искать файлы .cursorignore в родительских каталогах.

Глобальные файлы игнорирования

Задайте в пользовательских настройках шаблоны игнорирования для всех проектов, чтобы исключать конфиденциальные файлы без настройки каждого проекта. По умолчанию глобальный список игнорирования пуст.

Распространённые шаблоны:

• Файлы среды: **/.env, **/.env.*
• Учётные данные: **/credentials.json, **/secrets.json
• Ключи: **/*.key, **/*.pem, **/id_rsa

Файлы, игнорируемые по умолчанию

Cursor автоматически игнорирует файлы из .gitignore и списка игнорируемых по умолчанию файлов ниже. Чтобы отменить игнорирование, добавьте префикс ! в .cursorignore.

package-lock.jsonpnpm-lock.yamlyarn.lockcomposer.lockGemfile.lockbun.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/

Ограничения шаблонов исключения

При использовании шаблонов исключения (с префиксом !) нельзя повторно включить файл, если родительский каталог исключён с помощью *.

# Игнорировать все файлы в папке publicpublic/*# Это работает, так как файл находится на верхнем уровне!public/index.html# Это не работает: нельзя повторно включить файлы из вложенных папок!public/assets/style.css

Обходное решение: Явно исключите вложенные каталоги:

public/assets/*!public/assets/style.css # Этот файл теперь доступен

Исключённые каталоги не просматриваются для повышения производительности, поэтому шаблоны для файлов внутри них не учитываются. Это соответствует реализации .gitignore для шаблонов исключения во вложенных каталогах. Подробнее см. официальную документацию Git по шаблонам gitignore.

Устранение неполадок

Проверьте шаблоны с помощью git check-ignore -v [file].