Как исправить ошибку установки Python Pip в Ubuntu 24.04

При использовании команды pip для установки пакета Python в Ubuntu 24.04 выводится «ошибка: внешне управляемая среда». Вот несколько обходных путей, чтобы «исправить» проблему.

Как показывает вывод терминала, это изменение связано с PEP 668. Начиная с Ubuntu 23.04, он рекомендует использовать специфичные для Python инструменты управления пакетами (например, pip) для установки пакетов с использованием виртуальной среды, чтобы избежать конфликтов с пакетами, установленными менеджерами пакетов ОС. . Тем не менее, пользователь по-прежнему может заставить pip установиться в глобальный контекст интерпретатора, как и раньше.

В настоящее время существуют следующие способы решения этой проблемы:

Установите пакет Python из системного репозитория, если он существует.
Принудительно установить pip, как и раньше, в 22.04.
Вместо этого используйте pipx (только приложения Python).
Вручную создайте виртуальную среду и установите в нее пакет.

Вариант 1. Установите пакет Python из системного репозитория.

Debian и Ubuntu включают в себя несколько тысяч пакетов Python в системных репозиториях. Прежде чем устанавливать пакет через pip, лучше сначала посмотреть, доступен ли соответствующий пакет ОС.

Для этого либо используйте диспетчер пакетов Synaptic (доступен в Центре приложений), либо запустите команду sudo apt install python3- и нажмите «Tab», чтобы просмотреть доступные варианты.

Также на веб-странице packages.ubuntu.com предусмотрена функция поиска пакетов из системного репозитория.

Вариант 2. Принудительная установка pip, как и раньше.

Как показывает вывод ошибки терминала, пользователь может обойти эту проблему, добавив флаг --break-system-packages.

Например, принудительно установите библиотеку imagesearch с помощью команды:

pip install --user imagesearch --break-system-packages

Не вводя --break-system-packages каждый раз при запуске команды pip install, вы можете записать правило в файл конфигурации. Для этого просто выполните команды:

mkdir -p ~/.config/pip

echo -e "[global]\nbreak-system-packages=true" > ~/.config/pip/pip.conf

Команды сначала создадут папку ~/.config/pip, если она не существует, затем создадут файл конфигурации pip.conf и запишут в него следующие строки:

[global]
break-system-packages=true

После этого вы можете использовать команду pip install для установки пакетов Python, как в Ubuntu 22.04 и более ранних версиях.

Вариант 3. Используйте pipx.

Pipx — это альтернативный инструмент командной строки для установки и запуска приложений Python в изолированных средах. Однако это касается только приложений Python.

Чтобы установить и настроить pipx, просто запустите команду:

sudo apt install pipx

pipx ensurepath

Затем вы можете установить приложение Python через pipx, например Cowsay, используя команду:

pipx install cowsay

Затем запустите его через:

pipx run cowsay --text "Mooo"

И используйте команду для удаления пакета Python:

pipx uninstall cowsay

Чтобы узнать больше о pipx, запустите pipx --help или перейдите на страницу проекта.

Вариант 4. Создайте виртуальную среду для установки пакета Python вручную.

1. Если вы хотите вручную создать виртуальную среду для установки пакета Python в Ubuntu 24.04, откройте терминал и выполните команду:

python3 -m venv ~/.venv/cowsay

Эта команда создаст каталог .venv/cowsay в доме пользователя (замените cowsay на свое собственное имя). Запустив ls ~/.venv/cowsay, вы увидите, что папка содержит копию исполняемых файлов и библиотек Python.

2. После выполнения приведенной выше команды для создания виртуальной среды Python вы можете запустить команду pip из этого каталога, чтобы установить пакет Python. Например:

~/.venv/cowsay/bin/pip install cowsay

Наконец, запустите установленное приложение Python из этой виртуальной среды, выполнив команду:

~/.venv/cowsay/bin/cowsay -t "Mooooo"

Вы можете установить больше пакетов Python в эту единую среду (в моем случае .venv/cowsay) или снова запустить python3 -m venv ~/.venv/NAME_HERE, чтобы создать больше виртуальные среды для использования с другими пакетами.

Добавьте виртуальную среду в свой PATH

Не указывая полный путь к исполняемым файлам pip и python, вы можете добавить виртуальную среду Python в свой PATH.

Для этого либо запустите команду, которая работает только в текущем окне терминала:

export PATH=$HOME/.venv/cowsay/bin:$PATH

Или добавьте приведенную выше команду в файл .profile пользователя, выполнив команду ниже. Итак, он будет работать где угодно при следующем входе в систему! Для этого сначала запустите команду редактирования файла профиля пользователя:

nano ~/.profile

Когда файл откроется, прокрутите вниз и добавьте новую строку export PATH=$HOME/.venv/cowsay/bin:` PATH (замените cowsay на свой), наконец нажмите Ctrl. +S для сохранения, Ctrl+X для выхода.

Краткое содержание :

В этом уроке я научил, как обойти ошибку команды pip install в Ubuntu 24.04.

Для ленивых людей, которые хотят, чтобы все работало как раньше, просто добавьте параметр команды --break-system-packages, хотя это может что-то сломать. В то же время рекомендуемый способ — либо установить замену через пакет ОС (если таковой имеется), либо создать виртуальную среду и установить в нее пакет Python.