До установки зависимостей выясните, каким Python запускается приложение и кто управляет этим окружением. Системные пакеты дистрибутива и библиотеки одного приложения не должны случайно заменять друг друга. Для частных зависимостей выберите изолированное окружение или поддерживаемый механизм упаковки, а не принудительную запись в системный Python.
Запуск и установка должны смотреть в одно окружение
Команды чтения для диагностики выбранного Python:
python3 -c 'import sys; print(sys.executable); print(sys.prefix); print(sys.base_prefix)'
python3 -m pip --version
Запустить для интерпретатора, который использует launcher.
Отсутствие pip само по себе не означает поломку системного Python.Путь из sys.executable полезнее предположения «на машине стоит Python 3». Проверьте также источник импортируемой проблемной библиотеки в диагностической сессии без клиентских данных. Терминал и меню могут выбирать разные интерпретаторы, поэтому успешный ручной импорт не подтверждает работу упакованной программы.
| Модель доставки | Кто управляет зависимостями |
|---|---|
| Пакет дистрибутива | Системный пакетный менеджер |
| Частное venv приложения | Процесс установки и обновления приложения |
| Упакованный runtime | Сборка конкретного артефакта |
| Случайный пользовательский pip | Неустойчивая неявная зависимость |
EXTERNALLY-MANAGED сообщает границу ответственности
Спецификация PyPA Externally Managed Environments описывает маркер окружения, которым управляет внешний менеджер. Инструменты установки должны учитывать эту границу и направлять пользователя к подходящей изоляции. Источник проверен 27 октября 2026 года. Удаление маркера не решает конфликт владения пакетами.
Не меняйте системный симлинк Python и не применяйте обходные флаги защиты как постоянный рецепт доставки desktop-программы. От такого изменения могут зависеть утилиты ОС. Если программа распространяется как системный пакет, зависимости и совместимость должны быть выражены в правилах пакета дистрибутива.
Для отдельного окружения PyPA описывает venv и установку через pip внутри него. Но venv не добавляет автоматически другую поддерживаемую версию интерпретатора: базовый Python тоже должен подходить приложению. Проверяйте минимальную версию и доступность двоичных расширений на целевой системе.
Launcher должен вызывать выбранный интерпретатор явно. Активация venv в личном терминале не распространяется волшебным образом на запуск из меню. Не храните путь сборочной машины в установленной записи и не рассчитывайте, что пользователь всегда откроет программу из одной папки.
Обновление меняет комплект, а не случайные библиотеки
- Записать путь Python и способ управления окружением.
- Проверить зависимости в чистой тестовой установке.
- Запустить приложение из терминала и меню.
- Испытать обновление со старой поддерживаемой версии.
- Проверить удаление без повреждения системных пакетов.
Фиксируйте состав зависимостей и проверяйте его совместно. Обновление одной библиотеки на рабочей машине вручную может помочь локально, но не станет воспроизводимым исправлением пакета. Соберите новый проверяемый комплект и сохраните возможность вернуть предыдущую поддерживаемую конфигурацию.
Для двоичных расширений важны архитектура и совместимость с runtime и системными библиотеками. Сообщение ImportError не всегда связано с поиском Python-модуля: исследуйте точный текст и отсутствующую зависимость. Не копируйте произвольные системные библиотеки из другой машины ради исчезновения ошибки.
В комплект диагностики включите дистрибутив, архитектуру, путь интерпретатора, способ установки и обезличенное сообщение импорта. Правильный пакет запускается без ручной активации чужого окружения, обновляется предсказуемо и оставляет системный Python под управлением его владельца.