Павел Дронов

Где сломалосьГайд

Cursor AI не видит локальный проект на Python: как починить индексацию

Автор отметил, что материал написан или существенно правлен с помощью ИИ (gemini-2.5-flash).

Cursor AI не видит локальный проект на Python: как починить индексацию

Симптом: почему Cursor AI перестал искать по проекту на Python

Симптом простой: вызываешь чат, пишешь вопрос по коду, а редактор отвечает, что не знает структуру проекта, или выдает бесконечный статус индексации codebase. Для студии, где каждая минута разработчика стоит денег, это превращается в простой и раздражение.

Официальная документация Cursor и баг-трекеры на форумах подтверждают: проблема чаще всего кроется в игнорировании файлов (.gitignore), проблемах с правами доступа или огромном объеме виртуального окружения (.venv), которое редактор пытается просканировать вместо исходного кода.

  1. Индекс codebase зависает на 0% или бесконечно крутится.
  2. Поиск через собачку (@Codebase) не находит функции и классы в Python-файлах.
  3. Редактор видит только открытый в данный момент файл.

Воспроизведение проблемы и причины сбоя индексации

Чтобы понять, почему ломается поиск, нужно воспроизвести типичную ситуацию. Вы клонируете репозиторий с Python-проектом, открываете папку в Cursor, и внутри автоматически создается папка .venv с тысячами библиотек сторонних разработчиков.

Внутренний движок индексации пытается прочитать весь этот мусор, упирается в системные лимиты или падает по тайм-ауту. В результате база данных векторов ломается, и поиск по коду перестает работать полностью.

  1. Отсутствие папки .venv или кэша в файле .gitignore.
  2. Слишком большие файлы данных (.csv, .json, базы SQLite), попавшие в корень проекта.
  3. Устаревшая версия самого редактора Cursor, конфликтующая с локальным демоном Node.js.

Фикс шаг за шагом: как принудительно запустить индексацию Python-проекта

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

Второе действие — сброс локального индекса через палитру команд редактора. Это заставит Cursor пересоздать базу данных с нуля без старых ошибок.

  1. Нажмите комбинацию Ctrl+Shift+P (Cmd+Shift+P на Mac) для открытия палитры команд.
  2. Введите команду Cursor: Reindex Codebase или сбросьте настройки индексации.
  3. Убедитесь, что в корне проекта настроен корректный файл .gitignore с указанием .venv/, __pycache__/ и .pytest_cache/.

Проверка результата и безопасный откат настроек

После перезапуска индексации проверяем статус в настройках Cursor (раздел Features -> Indexing). Индикатор должен показывать прогресс и завершить его за несколько минут в зависимости от размера кодовой базы.

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

  1. Проверьте работу поиска, написав в чате @Codebase и задав вопрос по функции из другого файла.
  2. При нестабильной работе откатите версию Cursor на предыдущую стабильную через официальный сайт.

Источники

Cursor Forum - Codebase indexing not working on local folder: https://forum.cursor.com/Cursor Documentation - Troubleshooting Codebase Indexing: https://docs.cursor.com/

Источник: https://forum.cursor.com/

0
0

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

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

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

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

Ещё в теме «Бизнес на ИИ»

Похожие материалы и соседние разборы

Павел Дронов
Павел ДроновУровень Пилот

Зачем я полез с накладными в Claude 3.5 Sonnet Павел Дронов, хозяин торговой точки. Задачу оцифровки бумажных накладных и чеков я решал без иллюзий про полную автоматизацию. У меня есть пачка мятых бумажек от поставщиков, где вместо нормального ЭДО часто приносят блеклые ленты из принтера или заполненные от руки бланки. Обычные коробочные OCR-системы на таких документах стабильно ломаются, а отдавать бухгалтеру ручной ввод — это постоянные перепроверки. Решил проверить, как с этой рутиной справляется Claude 3.5 Sonnet через веб-интерфейс и API, опираясь на официальные спецификации модели и фактический прогон документов. Во сколько обошелся тест по API и через веб Если считать затраты по текущим тарифам Anthropic для Claude 3.5 Sonnet (3 доллара за миллион входных токенов и 15 долларов за миллион выходных), обработка одного среднего документа с

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

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

Дешевые CRM для малого бизнеса: топ и реальный счет за софтПоказать полностью
0
1
Павел Дронов
Павел ДроновУровень Пилот

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

Какие 5 сервисов онлайн-записи выбрать для малого бизнеса, чтобы не переплачиватьПоказать полностью
0
1
Никита Орлов

Зачем перебирать библиотеки для логирования python Привет! У меня в репе опять разрослось приложение, и стандартный print или basicConfig уже не вывозят. Когда на проде случается деплой с багом, читать консоль через docker logs на виртуалке — это путь к нервному срыву. Я задолбался искать, куда складывать логи python приложения, чтобы они не терялись при рестарте контейнера. Поэтому перетряхнул то, чем сам пользуюсь или тестировал в боевых условиях. Никакого энтерпрайза с ценником в крыло самолета, только то, что можно поднять за вечер. 1. Loguru: кому да, кому нет Начну с базы. Loguru — это любовь с первой строчки в мануале. Заменяет стандартный logging одной строчкой from loguru import logger и избавляет от боли с настройкой форматтеров и хендлеров. У меня она стоит на всех пет-проектах и в паре микросервисов. Красивый вывод в консоль из

Инструменты для мониторинга логов python топ 5: мой личный выборПоказать полностью
0
1
Павел Дронов
Павел ДроновУровень Пилот

Какая касса лучше для ИП на патент и как я выбирал аппараты для точек Привет! Я Павел Дронов, у меня тут своя точка, кручусь в рознице. Знаете этот момент, когда в пятницу вечером идет поток покупателей, очередь хвостом до двери, а касса вдруг зависает? Ты стоешь с чековой лентой в руках, потеешь, перезагружаешь этот «умный» аппарат и думаешь только о том, как бы не разбить его об пол. Прошел я через это не раз. Когда меня спрашивают, какие кассовые аппараты для ИП лучше выбрать, я сразу отсекаю всю эту маркетинговую шелуху про космические технологии. Мне надо, чтобы аппарат тупо работал, не выносил мозг техподдержкой, которая отвечает сутками, и чтобы фискальный накопитель не стоил как крыло от Боинга. Ну и чтобы для ИП на патент подходило идеально — без лишних танцев с бубном при сдаче отчетности. Сегодня разбираю пять самых ходовых моделей,

Какие кассовые аппараты для ИП лучше выбрать: топ 5 моделей глазами владельца точкиПоказать полностью
0
2
Никита Орлов

Как я выбирал фреймворки для локальных моделей python Привет! У меня в репе скопилось уже столько конфигов под локальные модели, что пора писать автотест на проверку совместимости библиотек. Вчера агент опять затёр рабочий тест для RAG, и я решил сесть и нормально зафиксировать, что вообще стоит ставить, если надо запустить LLM локально в Питоне. Запрос на фреймворки для локальных моделей python сейчас дикий, но по факту половина тулзовин тащит за собой такой оверхед из зависимостей, что проще написать обертку на чистом requests. Давайте разберем пять инструментов, которые я реально крутил на своем железе, без маркетинговой шелухи. 1. Ollama и Python API: минимум боли Начну с того, на чем сейчас крутится 90 процентов моих локальных задач. Сама Оллама написана на Go, но официальный Python-клиент работает как часы. Никаких танцев с компиляцией

ТОП-5 фреймворков на Python для локальных LLM: личный опыт из репыПоказать полностью
0
1