​
Обзор

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

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

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

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

Установите шаблоны игнорирования для всех проектов в пользовательских настройках, чтобы исключить конфиденциальные файлы без настройки для каждого проекта.
Глобальный список игнорирования Cursor
Шаблоны по умолчанию включают:
  • Файлы окружения: **/.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 для исключения файлов только из индексации. Эти файлы остаются доступными для функций ИИ, но не будут отображаться в поиске по кодовой базе.

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

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].