Обзор

Cursor читает и индексирует кодовую базу твоего проекта, чтобы обеспечивать работу своих функций. Контролируй, к каким каталогам и файлам Cursor имеет доступ, с помощью файла .cursorignore в корневом каталоге. Cursor блокирует доступ к файлам, перечисленным в .cursorignore, для:
Вызовы инструментов, инициированные Agent, например терминал и MCP‑серверы, не могут заблокировать доступ к коду, на который распространяется .cursorignore

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

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

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

Задай шаблоны игнорирования для всех проектов в пользовательских настройках, чтобы исключать чувствительные файлы без отдельной настройки для каждого проекта.
Global Cursor Ignore List
Стандартные шаблоны включают:
  • Файлы окружения: **/.env, **/.env.*
  • Учетные данные: **/credentials.json, **/secrets.json
  • Ключи: **/*.key, **/*.pem, **/id_rsa

Настройка .cursorignore

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

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

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

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

Включи Cursor Settings > Features > Editor > Hierarchical Cursor Ignore, чтобы искать .cursorignore в родительских каталогах. Примечания: Комментарии начинаются с #. Поздние шаблоны переопределяют более ранние. Шаблоны задаются относительно расположения файла.

Ограничь индексацию с помощью .cursorindexingignore

Используй .cursorindexingignore, чтобы исключать файлы именно из индексации. Эти файлы остаются доступны для AI-функций, но не отображаются в поиске по кодовой базе.

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

Cursor автоматически игнорирует файлы из .gitignore и из списка игнорирования по умолчанию ниже. Переопредели это с префиксом ! в .cursorignore.

Ограничения паттернов с отрицанием

При использовании паттернов с отрицанием (с префиксом !) нельзя повторно включить файл, если родительская директория исключена через *.
# Игнорировать все файлы в папке public
public/*

# ✅ Это работает, так как файл лежит на верхнем уровне
!public/index.html

# ❌ Это не работает — нельзя заново включать файлы из вложенных директорий
!public/assets/style.css
Обходной путь: Явно исключи вложенные директории:
public/assets/*
!public/assets/style.css # Теперь этот файл доступен
Исключённые директории не обходятся ради производительности, поэтому паттерны для находящихся в них файлов не действуют. Это соответствует реализации .gitignore для отрицательных паттернов во вложенных директориях. Подробности см. в официальной документации Git по паттернам gitignore.

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

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