Перейти к основному содержимому

Python в OpenIDE

OpenIDE — среда разработки на платформе IntelliJ, в которой Python работает в одном окне с остальным стеком: редактор с автодополнением и рефакторингами, запуск и отладка, тесты pytest, веб-фреймворки Django, Flask и FastAPI, блокноты Jupyter, база данных и HTTP-запросы. На этой странице — что поддерживается, как установить и настроить Python-проект и ответы на частые вопросы.

Редакция: язык, отладка и тесты — OpenIDE и OpenIDE Pro; Python-фреймворки и блокноты Jupyter — OpenIDE Pro.

Проект konfa в OpenIDE: в редакторе main.py с приложением FastAPI и обработчиками busiest_hall и halls; рядом с декораторами app.get подсказки с маршрутами GET /halls/busiest и GET /halls, пометка no tests и автор изменений. Слева дерево проекта с папкой stats, окружением .venv и файлами pyproject.toml и uv.lock

Python-файл в редакторе: у обработчиков FastAPI видны маршрут и автор изменений.

Что поддерживается​

ВозможностьЧто естьПлагин
РедакторПодсветка, автодополнение, подсказки имён параметров, число использований над объявлениями, проверки кодаPython Community Edition
Навигация и рефакторингПереход к определению, поиск использований, переименование по всему проектуPython Community Edition
ОкруженияСуществующий интерпретатор или новое окружение: virtualenv, conda, poetry, uv, hatchPython Community Edition
ЗапускКонфигурации запуска скриптов и модулей, значок запуска на полях редактораPython Community Edition
Тестыpytest: запуск файла, класса, теста или всей папки, дерево результатов, повторный запускPython Community Edition
ОтладкаТочки останова, шаги, значения переменных прямо в коде, панель переменных и кадровPython Community Edition
Веб-фреймворкиDjango, Flask, FastAPI: дерево моделей и эндпоинтов, запуск сервера, генерация HTTP-запросов и тестов, проверкиPython Frameworks
Блокноты.ipynb в редакторе, запуск ячеек на ipykernel из окружения проекта, таблицы DataFrame, графики matplotlibJupyter Notebooks
Базы данныхPostgreSQL, MySQL, ClickHouse, SQLite и другие: дерево схемы, SQL-консоль, данные в гриде, SQL-файлы проектаDB-клиент
HTTP-запросыConnekt: запросы к своему API, запрос по эндпоинту генерируется из схемы PydanticHTTP-клиент

Окно Python Frameworks: проект velopark, FastAPI 0.162.0, модели Pydantic Ride, RideCreate, Station с полями и четыре эндпоинта GET /stations, GET /stations/station_id, POST /rides, GET /stats/busiest

Окно Python Frameworks для проекта на FastAPI: модели Pydantic с полями и эндпоинты. Двойной клик открывает код.

Установка​

  1. Установите OpenIDE Pro — пробный период на 60 дней без регистрации.
  2. В Настройки → Плагины → Маркетплейс (Settings → Plugins → Marketplace) найдите и установите:
  3. Перезапустите IDE.

Плагины, которых нет в маркетплейсе внутри IDE, ставятся из файла — см. Маркетплейс и плагины.

Как настроить интерпретатор Python​

При первом открытии папки с Python-кодом IDE распознаёт фреймворк, но интерпретатор ещё не задан. В окне уведомлений появляется Python interpreter is not configured — например, «7 dependencies from pyproject.toml cannot be installed until an interpreter is configured».

Уведомления: «Python framework detected — Detected FastAPI in module 'velopark'» и «Python interpreter is not configured — 7 dependencies from pyproject.toml cannot be installed until an interpreter is configured»

Обратите внимание: интерпретатор настраивается так.

  1. Откройте Файл → Структура проекта… (File → Project Structure…), раздел Проект.

  2. В поле SDK раскройте список и выберите Добавить Python SDK с диска….

    Структура проекта, раздел «Проект»: поле SDK со списком SDK

  3. В окне Добавить интерпретатор Python:

    • если окружение уже есть (.venv, созданное uv sync или python -m venv), выберите Выбрать существующий, тип Python и в поле Путь Python — интерпретатор из окружения: .venv/bin/python (на Windows — .venv\Scripts\python.exe);
    • если окружения нет, выберите Создать новый, тип окружения (virtualenv, conda, poetry, uv, hatch), базовый Python и расположение.

    Окно «Добавить интерпретатор Python»: «Выбрать существующий», тип Python, путь ~/IdeaProjects/velopark/.venv/bin/python

  4. Нажмите ОК. Новый SDK появится в поле SDK проекта.

  5. Перейдите в раздел Модули, выберите модуль проекта, вкладка Зависимости. В поле Модуль SDK должен стоять SDK проекта (или тот же Python SDK).

    Структура проекта, «Модули → Зависимости»: «Модуль SDK: SDK проекта ~/IdeaProjects/velopark/.venv»

  6. Нажмите ОК и дождитесь окончания индексации.

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

Короткий путь

В уведомлении Python interpreter is not configured есть действие Use detected .venv — оно назначает найденное в проекте окружение модулю одним щелчком. Если результат не устроил, настройте интерпретатор по шагам выше.

Зависимости​

Пакеты, перечисленные в pyproject.toml или requirements.txt, но не установленные в окружении, IDE показывает в уведомлении Dependencies not installed с действием Install all. Если проект использует uv или poetry, удобнее ставить зависимости их командами в терминале IDE — uv sync, poetry install, — окружение подхватится автоматически.

Запуск и отладка​

  • Запуск файла или модуля. Значок запуска на полях редактора у if __name__ == "__main__": или в контекстном меню файла. Конфигурации запуска хранятся в списке на панели инструментов.
  • Веб-сервер. Для FastAPI, Flask и Django плагин Python Frameworks добавляет конфигурации FastAPI Server, Flask Server и Django Server. Приложение (например, velopark.main:app) находится автоматически. Подробнее — Запуск и отладка фреймворков.
  • Отладка. Поставьте точку останова щелчком по полю редактора и запустите конфигурацию под отладчиком. Значения переменных показываются прямо в коде рядом со строками, а также в окне Отладка на вкладке Потоки & Переменные.

Отладка теста: остановка на точке останова в pricing.py, значения minutes: 12, is_member: True и billable: -18 прямо в коде и в панели переменных

Тесты​

pytest запускается из контекста:

  • Один тест или файл — значок запуска на полях редактора рядом с функцией test_… или классом.
  • Вся папка — контекстное меню папки tests в окне Проект.

Результаты показываются деревом: упавшие тесты с сообщением assert, переход к строке, повторный запуск. Тот же тест можно сразу запустить под отладчиком.

Дерево результатов pytest: 1 test failed, 5 passed, упал test_member_short_ride_is_free

Веб-фреймворки: Django, Flask, FastAPI​

Плагин Python Frameworks сам определяет фреймворк модуля по файлам зависимостей, пакетам окружения и коду. Окно Python Frameworks показывает модели, эндпоинты, настройки и миграции; над обработчиками видно метод, путь и число тестов, которые их вызывают. Из контекстного меню эндпоинта можно сгенерировать HTTP-запрос Connekt с телом из схемы Pydantic или заготовку pytest-теста.

Сгенерированный Connekt-запрос POST /rides с телом из RideCreate и ответ сервера 201

Всё о фреймворках — в разделе Python-фреймворки.

Блокноты Jupyter​

Файлы .ipynb открываются блокнотом: ячейки кода и Markdown, запуск по одной или всех сразу, вывод под ячейкой. Ядро ipykernel берётся из окружения проекта, поэтому блокнот видит код и пакеты проекта. Таблицы DataFrame рисуются нативным гридом с типами столбцов, графики matplotlib — прямо в блокноте.

Блокнот october.ipynb: DataFrame с поездками нативной таблицей с типами столбцов, ссылка «Open in Data Viewer»

Если в окружении нет ipykernel, IDE предложит его установить. Подробности — в разделе Блокноты Jupyter.

База данных рядом с кодом​

DB-клиент подключается к базе проекта — например, к файлу SQLite в репозитории: + → Data Source → SQLite, путь к файлу, Test Connection. При первом подключении клиент предложит скачать JDBC-драйвер. SQL-файлы проекта привязываются к соединению из баннера над редактором (Связать с соединением и базой…) и выполняются в IDE — тот же запрос, который читает код.

SQL-файл queries/busiest_stations.sql, привязанный к соединению velopark, и результат запроса в гриде

Таблица открывается гридом с фильтром WHERE: например, cost < 0 находит поездки с отрицательной стоимостью.

Таблица rides базы velopark в гриде DB-клиента: фильтр WHERE cost &lt; 0, одна строка — поездка 3118 на станции 1, 12 минут, is_member = 1, cost = -126; внизу «Total: 1 rows (WHERE applied)»

Фильтр в гриде нашёл поездку с отрицательной стоимостью.

Подробности — в разделе DB-клиент.

Частые вопросы​

Что делать с уведомлением «Python interpreter is not configured»?​

Задать интерпретатор проекту и модулю — по шагам из раздела Как настроить интерпретатор Python. Пока интерпретатор не задан, зависимости не устанавливаются, а запуск и тесты не работают.

Проект открылся как Java-проект, в поле SDK стоит JDK. Это нормально?​

Да. Папку без настроек IDE открывает как обычный модуль и ставит ему SDK по умолчанию. Замените SDK на Python в Файл → Структура проекта… → Проект → SDK (File → Project Structure… → Project → SDK) и проверьте Модуль SDK в разделе Модули → Зависимости.

После «Configure interpreter…» открывается пустое окно настроек​

Настройте интерпретатор через Файл → Структура проекта… (File → Project Structure…) — по шагам из раздела Как настроить интерпретатор Python.

IDE перестала отвечать после «Use detected .venv»​

Закройте IDE (если окно не отвечает — завершите процесс через диспетчер задач). Затем:

  1. Запустите IDE и откройте Файл → Структура проекта… → SDK (File → Project Structure… → SDK). Удалите все записи Python, включая неиспользуемые. Нажмите ОК и перезапустите OpenIDE.
  2. Добавьте интерпретатор через Добавить Python SDK с диска… (а не через SDK → +).
  3. Назначьте его в разделах Проект и Модули.

Перед удалением записей сохраните логи (Помощь → Собрать логи и диагностические данные (Help → Collect Logs and Diagnostic Data)) и отправьте их в поддержку — это поможет разобраться в причине.

При запуске: «Пожалуйста, выберите модуль с действительным SDK Python»​

У модуля не задан интерпретатор. Откройте Файл → Структура проекта… → Модули → Зависимости (File → Project Structure… → Modules → Dependencies) и выберите Python SDK в поле Модуль SDK. Затем откройте Запустить → Редактировать конфигурации… (Run → Edit Configurations…) и выберите интерпретатор в конфигурации запуска.

Импорты стандартной библиотеки и пакетов подчёркнуты красным​

Дождитесь окончания индексации после выбора интерпретатора — пути библиотек IDE заполняет в фоне. Если подчёркивание не ушло, проверьте, что модулю назначен Python SDK (Модули → Зависимости), и что пакеты установлены в это окружение. Если и это не помогло — удалите интерпретатор в Структура проекта → SDK и добавьте заново.

Какие окружения поддерживаются?​

При добавлении интерпретатора доступны типы Python (virtualenv и любой существующий интерпретатор), conda, poetry, uv и hatch. Окружение, созданное снаружи (uv sync, poetry install, python -m venv .venv), подключается через Выбрать существующий.

Блокнот выполняется, но вывода нет (macOS)​

Проверьте, не открыт ли системный запрос macOS на доступ IDE к связке ключей: плагин блокнотов хранит в ней секрет для доверенных блокнотов, и пока запрос не подтверждён, вывод ячеек не появляется. Разрешите доступ и перезапустите ядро (Restart Kernel на панели блокнота).

Нужна ли редакция Pro?​

Язык, отладка и тесты доступны в бесплатной OpenIDE. Плагины Python Frameworks и Jupyter Notebooks работают в OpenIDE Pro. Сравнение редакций — в разделе Редакции.

Что приложить к обращению в поддержку?​

Архив из Помощь → Собрать логи и диагностические данные (Help → Collect Logs and Diagnostic Data), номер сборки из окна «О программе», версии плагинов Python (Настройки → Плагины → Установлено (Settings → Plugins → Installed)) и, если можно, минимальный проект, на котором воспроизводится проблема. Куда писать — в разделе Поддержка и обратная связь.