СтатьяГайдCursor AI не видит файлы проекта: как заставить агента сканировать репу

Cursor AI не видит файлы проекта: как заставить агента сканировать репу

Cursor AI не видит файлы проекта: в чём главная боль

У меня в репе вчера приключилась классическая засада: открываю проект, запускаю композит из агентов, а эта зараза в упор не видит новые компоненты, которые я только что набросал. Пишу в чат: «Посмотри логику в соседнем файле», а в ответ получаю классическое «я не могу найти этот файл в рабочей директории».

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

Как добавить папку в Cursor AI и проверить корень проекта

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

Проверьте, что в левой панели у вас открыт именно workspace, а не отдельный подкаталог. Если папка добавлена криво, агент будет видеть только её маленький мир.

  • Кликните в верхнем меню на File -> Open Folder и выберите корень с вашим package.json или go.mod.
  • Убедитесь, что в рабочей области нет дублирующих вложенных воркспейсов, которые путают поисковый движок.
Как добавить папку в Cursor AI и проверить корень проекта
IDE sidebar file tree open project

Cursor AI игнорирует gitignore: где искать подвох

Вторая частая причина — ваш файл .gitignore. Агенты в Cursor по умолчанию уважают правила Git, чтобы не тащить в контекст тонны мусора, папки node_modules, сборки или секретные env-файлы.

Но иногда под раздачу попадают конфиги, папки с бэкапами или сгенерированные схемы, которые нужны ИИ для работы. Если файл подсвечен серым или исключен из поиска, агент его просто не считает.

  • Гляньте в настройки редактора по запросу Use Ignore Files и проверьте, не включено ли там лишнее.
  • Создайте локальный файл .cursorignore, если хотите явно указать агенту, что именно игнорировать, не ломая при этом основной гитигнор.

Слетел индекс: как принудительно перезапустить сканирование

Иногда база данных индексов внутри Cursor просто ломается после обновления или резкого закрытия IDE. В таком случае файлы физически на диске есть, в дереве они отображаются, но поиск и чат их игнорируют.

Лечится это принудительным пересчётом эмбеддингов. Пришлось поискать в панели команд нужный пункт, потому что интуитивно он не бросается в глаза.

  • Откройте палитру команд через Ctrl+Shift+P или Cmd+Shift+P.
  • Найдите пункт Reindex Workspace или аналогичную команду сброса локального индекса кодовой базы.

Что ещё проверить в настройках, если файлы всё равно пропали

Если ничего из вышеперечисленного не помогло, проблема может крыться в глобальных исключениях самого движка VS Code, на базе которого собран Cursor.

Иногда туда попадают полезные расширения или специфические директории сгенерированного кода.

  • Загляните в Settings -> Search: Exclude и проверьте, нет ли там масок, блокирующих ваши рабочие папки.
  • Перезапустите IDE после любых правок в конфигурации, чтобы демон индексации подхватил изменения с чистого листа.
Что ещё проверить в настройках, если файлы всё равно пропали
settings menu IDE configuration screen

Итог: краткий чек-лист для спасения агента

В общем, если боитесь снова потерять контекст в процессе работы с кодом, держите мой личный мини-алгоритм действий:

Я не врач и не техподдержка разработчиков редактора, но этот набор шагов у меня в команде решает 99% подобных косяков с индексацией за пару минут.

  • Открыт ли именно корень репозитория?
  • Не прячется ли нужный файл за правилами gitignore?
  • Жив ли локальный индекс проекта?
  • Не заблокирован ли поиск в настройках exclude?
  • Помог ли банальный перезапуск воркспейса?
0
0

Комментарии (0)

Войдите, чтобы комментировать.

Без Plus — 5 комментариев в месяц. Мало слов — чистый воздух. Войти

Комментариев пока нет — будьте первым.

Ещё в теме «Код и разработка»

Посты других авторов с подпиской

Почему ChatGPT зависает или обрывает код на полуслове Понедельник, до обеда сорок минут, у меня открыта пачка вкладок, а дедлайн по скрипту — вчера. Я прошу модель написать кусок логики, она бодро начинает строчить знакомые строчки... и внезапно замирает. Курсор мигает, код оборван прямо посреди скобки, а сам ChatGPT как будто ушел на перекур. Знакомая картина? Такое случается постоянно, и дело тут не в магнитных бурях или личном злом умысле нейросети. У моделей есть жесткие технические ограничения, о которых на утренних презентациях обычно не рассказывают. Когда вы видите, что chatgpt останавливается посередине кода, это чаще всего упирается в системные лимиты на длину одного ответа. Я заглядывала в обсуждения на форумах — жалуются все, от джунов до лидов. Давайте разберем главные причины, почему эта штука тупит, когда вам срочно надо сдать

Показать полностью
0
0
Марина ВолковаУровень Пилот

Привет, офис и вечный голод У меня на столе всегда бардак, пара чашек остывшего кофе и острая жажда зажевать стресс чем-нибудь сладким. Знакомо? Сидишь перед монитором, до конца рабочего дня еще вечность, а в желудке прямо пустота. Причем голод какой-то злой — не просто поесть хочется, а именно вредного. Раньше я спасалась печеньками из общей кухни или шоколадками из автомата в коридоре. Результат был предсказуем: через полчаса сахар в крови падал еще ниже, работоспособность стремилась к нулю, а джинсы на талии начинали противно впиваться в тело. В общем, тему перекусов на работе я изучила на собственных боках. Никаких занудных советов про сушеный сельдерей или пресные хлебцы сегодня не будет. Я их сама терпеть не могу. Давайте честно: перекус должен быть вкусным, быстрым, не требовать сложных манипуляций на микрокрошечной офисной кухне и

Показать полностью
0
1
Софья ЛаринаУровень Пилот

Вместо введения: почему старые способы стирания логотипов больше не работают У меня на прошлой неделе горел проект: срочно понадобилось вставить в презентацию для клиента скриншот видео, а там по центру красовалась полупрозрачная плашка стока. Раньше мы с дизайнером открывали штамп в фотошопе и сидели медитативно замазывали каждый пиксель. На сплошном фоне это еще прокатывало, но если водяной знак падал на текстуру лица или сложный градиент — получалось такое откровенное мыло, что хоть плачь. Сейчас всё проще и сложнее одновременно. Появились нейросети, которые умеют дорисовывать скрытые под логотипом детали по контексту. Но тут кроется другая засада: половина сайтов по запросу «нейросеть убрать водяной знак с видео бесплатно» предлагают скачать какую-то сомнительную программу с вирусами или выдают результат с дикими артефактами. Я

Показать полностью
0
1
Марина ВолковаУровень Пилот
Оффтоп1 дн

Можно ли есть фрукты вечером худеющим на самом деле Знакомая картина: день держишься на гречке и грудке, а к вечеру накрывает такая тоска по сладкому, хоть плачь. У меня это классика жанра. Рука сама тянутся к вазе с фруктами, а в голове сразу голос внутреннего тренера: «Ты что, там же фруктоза, она вся в жир уйдёт!». Давайте честно, я через это прошла раз сто. Если коротко отвечать на вопрос, можно ли есть фрукты вечером при похудении и не толстеть от них — да, можно. От пары мандаринов или чашки клубники за полчаса до сериала вы не просберётесь с плюс килограммом на весах. Вес набирается от общего профицита калорий за сутки, а не от того, в котором часу вы съели яблоко. Если вы уложились в свою дневную норму, организму абсолютно всё равно, когда переваривать эту клетчатку — в два часа дня или в девять вечера. Почему так тянет на сладкое

Показать полностью
0
0
Софья ЛаринаУровень Пилот

Нейросети для видео топ 5: на чем мы реально работаем в студии Привет! У меня тут на днях сорвался подрядчик по графике, сроки сгорели, а заказчику нужен трехсекундный футуристичный пролет камеры для рекламного ролика. Пришлось срочно поднимать весь наш арсенал ИИ-инструментов, тестировать генерацию видео по тексту и собирать те ии сервисы, которые выдают результат не «в стиле психоделического сна собаки», а пригодную для продакшна картинку. Давайте честно: восторженных обзоров в сети полно, но когда дело доходит до правок клиента и формата 4K (или хотя бы нормального FullHD без мыла), половина хайповых нейросетей отваливается. Я отобрала пятерку инструментов, которые мы реально гоняем в хвост и в гриву на коммерческих проектах в этом сезоне. Смотрим, кому они подходят, а кому лучше обойти стороной. Runway Gen-2 и Gen-3: рабочая лошадка для

Показать полностью
0
1
Марина ВолковаУровень Пилот
Оффтоп1 дн

Какие каши самые полезные для похудения: мой опыт борьбы с крупами Привет! Я Марина, и за свою жизнь я, кажется, переварила центнер разной крупы. Когда я только начинала приводить себя в форму после тридцати, мне казалось, что достаточно просто заменить печеньки на овсянку — и вес пойдет вниз сам. Спойлер: нифига подобного. Я набирала вес на кашах быстрого приготовления, мучилась от голода через час после тарелки манки и чуть не возненавидела всю эту тему с ЗОЖем. Позже методом проб, ошибок и консультаций с нормальными спецами я поняла: не всякая каша одинаково полезна для талии. И сегодня я собрала топ-5 каш для похудения, которые реально работают у меня на кухне, а не в теории диетологов. Сразу оговорюсь: я не врач и не нутрициолог с корочкой, я просто делюсь тем, что помогло мне сбросить лишнее и не сорваться. Погнали разбираться с каждой

Показать полностью
0
1