pip WindowsLinuxmacOSPython 3

pip: pip использует другую версию Python, чем приложение

  • Обновлено
  • Чтение ≈ 3 минуты

Краткий ответ

Одна команда pip может относиться к Python 3.11, а программа запускаться на Python 3.12 или внутри .venv. Поэтому установка формально успешна, но нужной версии библиотеки в приложении нет.

В этой статье
  1. Что происходит и когда возникает ошибка
  2. Причины и признаки
  3. Подробная диагностика и исправление
  4. Проверка результата и действия при неуспехе

#Что происходит и когда возникает ошибка

Одна команда pip может относиться к Python 3.11, а программа запускаться на Python 3.12 или внутри .venv. Поэтому установка формально успешна, но нужной версии библиотеки в приложении нет.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Команды python и pip из разных папокPATH выбирает самостоятельные исполняемые файлы.pip --version показывает иной Python, чем python --versionСвязать pip с интерпретатором через -m.
Несколько версий PythonНа машине установлены несколько Python, каждый с собственными пакетами.После выбора интерпретатора в редакторе всё меняетсяВыбирать версию явным путём или через py -3.x.
Сервис имеет иной исполнительСлужба запускается другим пользователем и/или Python.В терминале импорт работает, в приложении-службе — нетИсправить команду запуска сервиса.

#Подробная диагностика и исправление

  1. Сравните версии и местоположенияВ терминале проекта последовательно выполните команды. В строке pip ... (python X.Y) сравните X.Y с выводом python --version. Если отличаются, причина почти найдена. В Windows where python и where pip показывают порядок найденных файлов, в Linux/macOS — command -v.
    Linux · Терминал (Bash)Команда
    Обычный терминал; дополнительных прав не требуется.
    python --version
    python -m pip --version
    pip --version
  1. Посмотрите реальный исполняемый файлВыполните короткую команду и сохраните путь sys.executable. Сравните его со значением в конфигурации редактора, сервиса или планировщика. Пример C:\...\Python312\python.exe означает отдельную установку от .venv\Scripts\python.exe.
  2. Подходит для всех систем при правильной команде python
    Linux · Терминал (Bash)Команда
    Подходит для всех систем при правильной команде python.
    python -c "import sys; print(sys.executable)"
  1. На Windows выберите нужную версию явноЕсли установлен Python Launcher, py -0p показывает доступные интерпретаторы и пути; команда может не работать в новых инсталляциях без пусковой утилиты. Затем py -3.12 -m pip --version проверяет pip именно версии 3.12. Если версия иная, подставьте свою; на Linux/macOS используйте исполняемый файл конкретного Python.
  2. Только Windows с установленным py launcher; 3.12 — пример, а не обязательная версия
    Linux · Терминал (Bash)Команда
    Только Windows с установленным py launcher; 3.12 — пример, а не обязательная версия.
    py -0p
    py -3.12 -m pip --version
  1. Создайте среду из целевого PythonВ папке проекта выберите требуемый интерпретатор и выполните создание нового окружения в отдельной папке, например .venv-new. Проверьте, что в ней есть Python нужной версии. Не перезаписывайте рабочее .venv до успешного запуска приложения.
    Linux · Терминал (Bash)Команда
    .venv-new создаётся из именно того python, который найден предыдущей командой.
    python -m venv .venv-new
  1. Установите зависимости и проверьтеАктивируйте новую среду или используйте её Python по полному пути. Установите зависимости из файла проекта, если он есть. Затем вызовите python -m pip check: при исправных требованиях будет No broken requirements found.; эта проверка не гарантирует отсутствие ошибок самого приложения.
    Linux · Терминал (Bash)С осторожностью
    Команды выполняйте только после активации новой среды; если файла requirements.txt нет, установите заявленные зависимости по документации проекта.
    python -m pip install -r requirements.txt
    python -m pip check

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

  1. Исправьте путь запуска приложенияДля IDE, рабочего процесса и службы выберите Python из новой среды; повторите тест. Если проблема осталась, запишите версию и путь прямо внутри падающего процесса. Не удаляйте исходное окружение, пока вся проверка не пройдена.

#Проверка результата и действия при неуспехе

При запуске приложения и при вызове python -m pip --version используются совпадающие Python и каталог окружения; нужные модули импортируются.

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

Так эту ошибку тоже называют

pip: error: externally-managed-environment — причины и решение Ошибка pip «externally-managed-environment» защищает системный Python в Debian, Ubuntu, Fedora и Homebrew. Создайте виртуальное окружение venv, используйте pipx для утил… Программирование и базы данных pip WindowsLinuxmacOS pip: «не является внутренней или внешней командой» / command not found — причины и решение pip не найден, если Python не добавлен в PATH. Используйте python -m pip или переустановите Python с опцией Add to PATH. Программирование и базы данных pip WindowsLinuxmacOS pip: Could not find a version that satisfies the requirement — причины и решение Проверьте имя пакета, версию Python и индекс пакетов. Программирование и базы данных pip LinuxWindowsmacOS pip: No matching distribution found for пакет — причины и решение pip не нашёл подходящую версию пакета: опечатка в названии, пакет не поддерживает вашу версию Python или платформу, либо нет доступа к индексу. Ниже — причины и порядок … Программирование и базы данных pip WindowsLinux pip: команда «pip» не распознана как имя командлета — причины и решение Команда pip не найдена, потому что Python не добавлен в PATH либо pip не установлен. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных pip Windows

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.