Как исправить ошибку pipx: Fatal error from pip prevented installation и No module named pip
После обновления Ubuntu 22.10 до версии 23.04 на ноутбуке перестал нормально работать pipx. Попытка установить Python-приложение завершалась сообщением:
```text
Fatal error from pip prevented installation
```
В некоторых случаях дополнительно появляется ошибка:
```text
No module named pip
```
Проблема может возникнуть не только в Ubuntu. Аналогичный сбой встречается и в других дистрибутивах Linux, особенно после обновления системных пакетов, смены версии Python или удаления компонентов, которые использовались прежней установкой pipx.
Для чего нужны pip и pipx
`pip` - стандартный менеджер пакетов Python. С его помощью устанавливают библиотеки и приложения из PyPI, однако при глобальной установке зависимости разных программ могут конфликтовать между собой.
`pipx` предназначен главным образом для Python-приложений командной строки. Он создаёт отдельное виртуальное окружение для каждой программы и устанавливает туда сам пакет вместе с необходимыми зависимостями. Благодаря этому системная среда Python остаётся чистой, а приложения не мешают друг другу.
После обновления Ubuntu путь к интерпретатору Python или модулю `pip` может измениться. В результате старое виртуальное окружение pipx продолжает ссылаться на уже недоступные файлы. Именно поэтому команда pipx запускается, но не может завершить установку приложения.
Почему появляется ошибка
Наиболее распространённая причина - повреждённое или устаревшее окружение pipx. Например, прежняя версия была создана на базе Python 3.10, а после обновления система перешла на Python 3.11. Сам pipx при этом может оставаться установленным, но его внутренний `pip` уже отсутствует либо больше не совместим с текущей конфигурацией.
Перед исправлением стоит проверить, какая версия Python используется системой:
```bash
python3 --version
```
Затем убедитесь, что пакет pip доступен отдельно:
```bash
python3 -m pip --version
```
Если команда сообщает, что модуль не найден, сначала потребуется установить системные компоненты Python. В Ubuntu это обычно делается так:
```bash
sudo apt update
sudo apt install python3-pip python3-venv
```
Пакет `python3-venv` также важен: без него pipx не сможет создавать изолированные виртуальные окружения.
Переустановка pipx
Если установка `pip` не решила проблему, наиболее надёжный вариант - удалить старую копию pipx и установить её заново из репозитория Ubuntu:
```bash
sudo apt remove pipx
sudo apt install pipx
```
После этого добавьте каталог локальных исполняемых файлов в переменную `PATH`:
```bash
pipx ensurepath
```
Изменения обычно применяются после нового входа в систему. Можно также перезапустить текущую оболочку или вручную перечитать конфигурацию shell.
Для полного исправления ошибки pipx Fatal error from pip иногда требуется удалить старое пользовательское окружение pipx. Это особенно актуально, если проблема появилась сразу после обновления Ubuntu:
```bash
rm -rf ~/.local/pipx
```
После удаления каталога установите нужное приложение повторно:
```bash
pipx install имя-пакета
```
Перед выполнением этой команды желательно проверить, что pipx действительно доступен:
```bash
pipx --version
```
Если pip установлен, но pipx всё ещё не работает
Иногда `python3 -m pip --version` выполняется без ошибок, однако pipx продолжает выдавать сообщение `No module named pip`. В таком случае проблема находится не в системном Python, а внутри конкретного окружения pipx.
Полезно переустановить приложение, которое вызывает сбой:
```bash
pipx uninstall имя-пакета
pipx install имя-пакета
```
Если удалить пакет обычной командой не удаётся, можно очистить каталог `~/.local/pipx` вручную, а затем заново запустить установку. Такой способ часто помогает, когда pipx broken after Ubuntu upgrade - "сломался после обновления Ubuntu".
Тем, кто ищет решение по запросу pipx no module named pip fix, следует учитывать: повторная установка только самого приложения не всегда достаточна. Нужно восстановить связку `python3-pip` и `python3-venv`, после чего пересоздать окружение pipx.
Альтернативная установка через официальный установщик
В некоторых версиях Ubuntu пакет pipx в стандартном репозитории может быть устаревшим. Тогда можно использовать установку через Python:
```bash
python3 -m pip install --user pipx
python3 -m pipx ensurepath
```
Однако такой вариант следует применять осторожно. Установка системных Python-пакетов через `sudo pip` нежелательна, поскольку она может конфликтовать с пакетным менеджером APT. Используйте пользовательскую установку с параметром `--user`, а для запуска команд - отдельные виртуальные окружения.
Если требуется выполнить how to reinstall pipx on Ubuntu, безопаснее начать с удаления старой версии, установки `python3-pip` и `python3-venv`, а затем выбрать один способ - через APT или пользовательский Python-инсталлятор. Не стоит одновременно смешивать несколько методов без необходимости.
Проверка результата
После восстановления проверьте работу pipx на простом приложении:
```bash
pipx install cowsay
cowsay "pipx работает"
```
Если программа установилась и запускается, окружение создано корректно. При необходимости список установленных приложений можно посмотреть командой:
```bash
pipx list
```
В отдельных случаях после изменения `PATH` терминал продолжает использовать старую конфигурацию. Тогда закройте окно терминала, откройте новое и повторите проверку. Также можно проверить расположение исполняемого файла:
```bash
which pipx
```
Если команда ничего не выводит, проблема связана не с Python, а с переменной окружения `PATH`.
Таким образом, для сценария how to fix pipx fatal error from pip prevented installation обычно достаточно установить `python3-pip` и `python3-venv`, пересоздать пользовательское окружение pipx и убедиться, что каталог `~/.local/bin` добавлен в `PATH`. Дополнительные варианты восстановления и команды для разных конфигураций Linux собраны в материале о переустановке pipx и устранении ошибки No module named pip.
