Никита Орлов
Никита ОрловТариф БортинженерКод и разработка

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

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
25

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

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

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

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

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

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

Марина Волк
Марина ВолкТариф Бортинженер
Оффтоп22 сент.

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

Показать полностью
0
29
Марина Волк
Марина ВолкТариф Бортинженер
Оффтоп22 сент.

Что на самом деле можно перенести из FatSecret Я проверяла это сама: прямой кнопки «Импортировать из FatSecret» в MyFitnessPal нет и никогда не было. Это я уже пробовала искать в настройках на той неделе. Официальная справка обеих платформ подтверждает: автоматический перенос истории съеденных блюд, веса и созданных рецептов между этими сервисами не поддерживается. Придется смириться с тем, что старый дневник питания останется в прошлом. Как сохранить свои рецепты из FatSecret Единственный нормальный способ не потерять нажитое — это перенести рецепты через буфер обмена или просто переписать их наброски. Я открываю оба приложения на экране планшета и телефона одновременно. В FatSecret заходим в раздел «Моя еда» или «Рецепты», открываем нужный состав блюда и копируем граммовки. В MyFitnessPal в разделе «Еда» выбираем создание нового рецепта и

Как перенести данные из FatSecret в MyFitnessPalПоказать полностью
0
10
Никита Орлов
Никита ОрловТариф Бортинженер

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

Как не упереться в лимит запросов в Claude Code и что делатьПоказать полностью
0
17
Никита Орлов
Никита ОрловТариф Бортинженер

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

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

Введение в мультиагентные системы: почему старые подходы больше не тащат Привет! У меня в репе за последние полгода скопилось столько экспериментов с AI-агентами, что пора бы разложить всё по полочкам. Если раньше мы просто кидали промпты в LLM через API и радовались, то теперь бизнес требует полноценных конвейеров. Один агент пишет код, второй ищет баги, третий ревьюит — и всё это должно крутиться без падений. Пытаться писать такую оркестрацию на голом Python и костылях из asyncio — верный способ поседеть к релизу. Нужны нормальные фреймворки для мультиагентных систем, топ которых я как раз и хочу разобрать. Ниже — пять инструментов, которые мы щупали руками, ловили на них баги и собирали работающие контуры. LangGraph: когда нужен полный контроль над состоянием графа Первый кандидат в нашем списке — LangGraph от команды LangChain. Я начинал с

Фреймворки для мультиагентных систем: топ-5 инструментов в 2025Показать полностью
0
27
Никита Орлов
Никита ОрловТариф Бортинженер

Claude Code — автономный агент от Anthropic для работы в терминале с доступом к файловой системе и git, в то время как GitHub Copilot CLI расширяет экосистему GitHub для выполнения команд через интерфейс командной строки. Инструменты подходят бэкенд-разработчикам и DevOps-инженерам для терминальной автоматизации; версия Claude Code распространяется по модели исследовательской превью-версии (research preview), а Copilot CLI требует активной подписки GitHub Copilot. Архитектура агентов Claude Code и GitHub Copilot CLI Архитектура Claude Code построена как автономный агент командной строки, который самостоятельно выполняет чтение файлов, поиск по кодовой базе, запуск тестов и формирование git-коммитов. Агент запрашивает у пользователя подтверждение перед потенциально опасными операциями записи. GitHub Copilot CLI функционирует преимущественно как

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