Никита Орлов

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

Cursor IDE не видит Python в venv: причины и исправление

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

Симптом: Cursor IDE не видит локальный интерпретатор Python

Симптом: при открытии проекта в Cursor IDE линтер ругается на отсутствие модулей, а в правом нижнем углу или через палитру команд не удается выбрать локальный интерпретатор из папки .venv.

Поведение воспроизводится при открытии нового воркспейса на базе стандартного модуля venv или Poetry без явно прописанных путей в конфигурации рабочей зоны.

  1. Ошибка импорта модулей в редакторе при рабочем терминале.
  2. Отсутствие папки .venv в списке предлагаемых интерпретаторов.
  3. Использование глобального системного Python вместо изолированного окружения.

Причина сбоя: расхождение путей в settings.json и workspace

Поскольку Cursor построен на базе VS Code, он использует те же механизмы поиска интерпретаторов, но часто теряет контекст проекта из-за структуры вложенных папок или монорепозиториев.

Если в настройках воркспейса жестко не зафиксирован путь к исполняемому файлу python, сканер окружения падает по таймауту или берет дефолтную системную версию.

  1. Отсутствие файла settings.json в директории .vscode.
  2. Неверный путь к бинарнику в ОС Windows (Scripts вместо bin).
  3. Конфликт между глобальным Poetry и локальным venv.

Фиксим через ручную правку settings.json

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

Создайте или откройте файл .vscode/settings.json в корне вашего репозитория и добавьте параметр python.defaultInterpreterPath.

  1. Для Linux и macOS путь выглядит как .venv/bin/python.
  2. Для Windows путь выглядит как .venv\Scripts\python.exe.
  3. Пример строки: «python.defaultInterpreterPath»: «./.venv/bin/python».

Интеграция с Poetry в Cursor IDE

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

Нужно узнать точный путь к виртуальному окружению командой poetry env info --path и подставить его в настройки воркспейса.

  1. Выполнить в терминале команду poetry run which python или poetry env info.
  2. Скопировать полученный путь.
  3. Вставить путь в python.defaultInterpreterPath внутри settings.json.

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

После сохранения файла settings.json перезапустите окно редактора через палитру команд: Developer: Reload Window.

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

  1. Убедитесь, что файл settings.json не содержит синтаксических ошибок в JSON.
  2. При возникновении проблем просто удалите добавленные строки из settings.json для возврата к автоопределению.

Источники

Cursor Documentation: Python Environment: https://docs.cursor.com/Visual Studio Code Documentation: Python environments: https://code.visualstudio.com/docs/python/environments

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

0
1

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

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

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

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

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

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

Никита Орлов

Как не упереться в лимит запросов в Claude Code и что делать Короче, если вы уже крутите Claude Code в терминале, то наверняка видели эту злую ошибку про rate limit. Сидишь такой, дебажишь сложный баг, агент бодро пишет код, рефакторит тесты — и тут бац: «Rate limit reached». Всё, приплыли, кукушка говорит «ждите час» или сколько там до сброса. У меня такое происходит регулярно, если дать агенту волю. Раньше я просто пускал его в проект и говорил: «Почини всё». Это главная ошибка. Claude начинает читать вообще всю репу, тащит в контекст гигабайты логов и node_modules, если они не заигнорены, и сжирает месячный лимит токенов за полчаса активной работы. Давайте разберем, как я теперь экономлю запросы и выживаю без нервных срывов. Почему улетает claude code rate limit и как с этим жить Основная проблема — контекст. Агенты устроены так, что с

Как не упереться в лимит запросов в Claude Code и что делатьПоказать полностью
0
1
Марина Волкова
Марина ВолковаУровень Пилот

Симптом: почему в FatSecret обнулились калории и завис дневник На той неделе я открыла приложение посреди дня, чтобы записать обед, а там — классическая пустота. Круговая диаграмма КБЖУ показывает нули, вчерашний ужин куда-то испарился, а при попытке добавить продукт кнопки просто не реагируют на нажатия. Это я уже пробовала: перезагружала экран, махала пальцем по ленте, но интерфейс висел мертво. Судя по обращениям пользователей в техподдержку FatSecret, проблема обычно связана со сбоем синхронизации серверов или повреждением локального кэша на телефоне. Приложение пытается отправить данные в облако, зависает в офлайн-режиме и блокирует ввод новой еды. Воспроизведение и локализация ошибки синхронизации Чтобы понять, где именно застряли калории, я проверила веб-версию. Зашла через обычный браузер с компьютера под тем же логином. Оказалось, что

Показать полностью
0
1
Никита Орлов

Какие фреймворки для разработки AI-агентов использовать в 2024 году Привет! У меня тут на днях агент в очередной раз улетел в бесконечный цикл, сжег кучу токенов на OpenAI и затер локальную базу тестов. Классика для ночной смены. Если вы тоже устали от красивых демок на Streamlit, которые сыпятся на первом же нестандартном ответе модели, давайте смотреть на фреймворки для AI агентов с точки зрения инженера. Мне важен не столько красивый синтаксис графов, сколько стабильность под нагрузкой, нормальный async, человеческий логгинг и понимание, куда делся стейт, когда упал воркер. Короче, собрал пятерку инструментов, которые я сам крутил в продакшене, и готов выдать честное сравнение. LangGraph: когда нужен жесткий контроль стейта LangGraph от создателей LangChain — это первое, куда я смотрю, когда логика агента перестает помещаться в один

Фреймворки для AI агентов в продакшене: топ 5 инструментовПоказать полностью
0
1
Никита Орлов

Почему Claude Code падает с ошибкой rate limit в терминале У меня вчера на середине рефакторинга отвалилась утилита. Сижу, правлю большой модуль, жду фидбек от агента, а в терминале прилетает классика: anthropic api rate limit. Процесс обрывается, контекст теряется, настроение так себе. Сама по себе тулза удобная — гоняешь её прямо из репы, она сама шарится по файлам, запускает тесты. Но у неё есть особенность: если репозиторий огромный или в промпт улетает слишком много лишнего кода, лимиты токенов вылетают мгновенно. Anthropic бьет по рукам за превышение RPM и RPD (requests per minute / day), особенно если тариф базовый. Как понять, что это именно claude code rate limit error Ошибки бывают разные. Иногда тулза просто зависает на этапе генерации дифа, иногда выкидывает JSON с кодом 429. Если вы видите в логах упоминание «Too Many Requests»

Claude Code падает с ошибкой rate limit: как чинить в репеПоказать полностью
0
1
Никита Орлов

Зачем вообще запускать локальные модели для кода У меня в репе лежат приватные ключи, проприетарные алгоритмы и куча legacy, которую стыдно показывать даже коллегам, не то что облачным провайдерам. Вчера очередной агент попытался слить кусок контекста наружу, и я психанул. Решил, что хватит кормить чужие датасеты своими энтерпрайз-костылями. Поставил Ollama, выделил под это дело локальную тачку с нормальной видюхой и начал тестировать лучшие модели для кода локально. Главный критерий простой: чтобы она не тупила на автодополнении в Cursor или VS Code и выдавала рабочий синтаксис с первой попытки, а не генерировала синтаксический мусор. Ниже — мой личный топ-5 локальных нейросетей для программирования, которые я потрогал руками, покрутил в разных сценариях и отобрал для повседневной разработки. 1. DeepSeek-Coder-V2: тяжёлая артиллерия для

Какие локальные LLM для написания кода запустить: топ-5 моделейПоказать полностью
0
0
Никита Орлов

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

Топ 5 ошибок при промптах для кода: почему модель ломает репуПоказать полностью
0
1