- В новых версиях Cursor больше нет прежнего отдельного семантического индекса репозитория с серверными эмбеддингами.
- .gitignore задаёт правила Git; Cursor учитывает эти исключения.
- В сообщении агенту можно явно указать нужный файл или папку через механизм упоминаний.
- В монорепозитории легко перепутать одноимённые компоненты разных приложений.
- Перед включением индексации внутреннего репозитория проверьте правила организации и условия обработки кода.
Для работы Cursor с большим репозиторием важно, какие файлы доступны поиску и что получает агент в контексте. Если индексация неполная, модель может не увидеть нужную функцию; если открыты лишние каталоги, поиск засоряется сборочными файлами, а секреты могут оказаться доступны инструментам. Поэтому настройка индексации начинается с карты проекта и правил доступа.
Как Cursor ищет код сейчас: Instant Grep
В новых версиях Cursor больше нет прежнего отдельного семантического индекса репозитория с серверными эмбеддингами. Agent использует Instant Grep и чтение обычных файлов. Индекс для быстрого поиска формируется локально. Поэтому советы «нажмите Reindex» и ожидание старого индикатора индексации могут не соответствовать актуальной версии продукта.
В Cursor Settings найдите раздел Code Intelligence либо Indexing и переключатель Index Repositories for Instant Grep. Внешний вид может различаться. Проверьте поиск точного имени функции, пути файла и текста ошибки. Если результат неожиданно пуст, уточните корень проекта и исключения, затем сравните поиск с обычным поиском редактора. Не удаляйте историю и конфигурацию ради переиндексации.
Чем .cursorignore отличается от .gitignore
.gitignore задаёт правила Git; Cursor учитывает эти исключения. .cursorignore дополнительно запрещает передавать совпавшие файлы обычным функциям ИИ-контекста. При этом терминал и MCP-инструменты работают с собственными правами и могут читать файлы, исключённые из контекста. Поэтому не храните действующие секреты в доступном агенту проекте и не считайте ignore полноценной системой разграничения доступа.
# .cursorignore
node_modules/
dist/
coverage/
*.log
.env*
**/*.pem
Проверьте, что список исключений не скрывает тесты и исходники. Большому монорепозиторию полезнее указывать агенту точный пакет и имя функции, чем отправлять сразу весь код.
Как давать точный контекст через файлы
В сообщении агенту можно явно указать нужный файл или папку через механизм упоминаний. Пример: «Изучи обработчик отправки заказа и связанные тесты. Не меняй другие модули до объяснения зависимости». Такой запрос ограничивает поиск и помогает оценить результат. Если агент ссылается на неверную функцию, попросите назвать путь и цитировать сигнатуру, а не доверяйте общей формулировке.
| Проблема | Проверка |
|---|---|
| Файл не находится | Корень проекта и правила ignore |
| Неверный модуль | Явно указать путь в сообщении |
| Ответ устарел | Проверить поиск и заново прочитать свежий файл |
| Лишний контекст | Исключить артефакты и архивы |
| Секрет доступен | Ограничить права и хранение |
Моно-репозиторий и несколько пакетов
В монорепозитории легко перепутать одноимённые компоненты разных приложений. Указывайте пакет, его точку входа и связанную область тестов. Для многофайловых изменений составьте план по пакетам, определите границы публичных интерфейсов и зафиксируйте их тестами. Указание «измени весь проект» плохо контролируется и повышает риск побочных изменений.
Безопасность контекста
Перед включением индексации внутреннего репозитория проверьте правила организации и условия обработки кода. Удалите из проекта незашифрованные ключи, не предоставляйте агенту лишние каталоги и используйте отдельные тестовые учётные данные. Вопросы защиты данных при командной работе подробнее описаны в статье Cursor для бизнеса.
Если поиск по проекту возвращает пустые результаты
Проверьте три независимые причины. Во-первых, убедитесь, что открыли корень нужного репозитория, а не соседнюю папку. Во-вторых, посмотрите, не исключён ли файл через .gitignore или .cursorignore. В-третьих, проверьте переключатель локального Instant Grep и попробуйте обычный поиск по файлам. Если поиск находит точную строку, но Agent отвечает не по той функции, явно укажите путь и попросите сравнить найденный код с тестом. Не нужно очищать пользовательскую историю, удалять индекс наугад или предоставлять доступ к закрытым каталогам.
Как оценить результат
Попросите Cursor найти три известных модуля и объяснить их взаимосвязь. Сверьте пути и тесты. Если ответы точны, переходите к небольшой правке. Для выбора модели, которая лучше справляется с длинным кодом, есть разбор моделей Cursor.
Почему поиск не видит файл, который есть на диске?
Причиной могут быть открытая не та папка, исключение через ignore, ограничения поиска Instant Grep или ограничения доступа. Проверяйте причины последовательно.