pip install -U pip error: externally-managed-environment × This environment is…
- User
pip install -U pip error: externally-managed-environment
× This environment is externally managed ╰─> To install Python packages system-wide, try apt install python3-xyz, where xyz is the package you are trying to install.
If you wish to install a non-Debian-packaged Python package, create a virtual environment using python3 -m venv path/to/venv. Then use path/to/venv/bin/python and path/to/venv/bin/pip. Make sure you have python3-full installed. If you wish to install a non-Debian packaged Python application, it may be easiest to use pipx install xyz, which will manage a virtual environment for you. Make sure you have pipx installed. See /usr/share/doc/python3.12/README.venv for more information.note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages. hint: See PEP 668 for the detailed specification.
как это исправить?
Assistant
Классическая ошибка на новых системах Linux (особенно на Ubuntu 23.04 и новее, Debian 12 и т.п.)!
Не волнуйся, это не баг, а фича. Рассказываю, что происходит и как это "исправить" (на самом деле, сделать правильно).
Что случилось?
Начиная с Python 3.11 (и активно внедряется в 3.12), дистрибутивы Linux (Debian/Ubuntu и пр.) начали помечать системный Python-environment как "externally managed" (внешне управляемый). Это нововведение связано с PEP 668.
Смысл в следующем:
- Системный Python (тот, что установлен как часть ОС, например,
/usr/bin/python3) теперь защищён от изменений черезpip install"напрямую". - Разработчики дистрибутивов хотят, чтобы:
- Системные пакеты Python ставились только через родной менеджер пакетов (
apt,dnfи т. д.). Например,apt install python3-requests. - Пользовательские/проектные пакеты ставились либо в виртуальных окружениях (
venv), либо черезpipx(об этом ниже).
- Системные пакеты Python ставились только через родной менеджер пакетов (
Почему так? Исторически сложилась беда:
- Многие пользователи запускали
sudo pip installи засоряли/ломали системные зависимости (ведь системный Python используется самой ОС: например, в Ubuntu куча утилит написаны на Python). - Обновления ОС могли всё сломать, если pip-пакеты конфликтовали с apt-пакетами.
Теперь решения (и это не "ошибка", а руководство к действию):
Вариант 1: Использовать виртуальное окружение (
venv) (Рекомендованный способ!)- Установим нужные пакеты для работы с venv (если ещё не установлены):
sudo apt update sudo apt install python3-full python3-venv - Создаём виртуальное окружение (например, для проекта
myproject):mkdir ~/myproject && cd ~/myproject python3 -m venv .venv # (.venv - скрытая папка с виртуальным окружением) - Активируем его:
Ты увидишь приставкуsource .venv/bin/activate(.venv)в терминале — это значит, что ты "внутри" виртуального окружения. - Теперь можно обновлять pip и ставить пакеты без ограничений:
pip install -U pip pip install requests numpy # любые другие нужные библиотеки - Когда закончил, деактивируй venv:
deactivate
Плюсы: Изоляция проекта, не трогается системный Python. Удалить проект? Просто
rm -rf ~/myproject— и всё чисто!Вариант 2:
pipx— для прикладных программ (рекомендуется для утилит типаyoutube-dl,ansible,poetryи т. д.)- Установи
pipx(это обёртка, создающая отдельные venv для каждого приложения):
(Последняя команда прописывает пути, перезапусти терминал или сделайsudo apt install pipx pipx ensurepathsource ~/.bashrc) - Теперь ставь приложения:
Примеры:pipx install PACKAGE_NAME
Запустить можно сразу после установки (пропишетсяpipx install youtube-dl # поставит youtube-dl в свой отдельный venv pipx install poetry # для управления Python-проектами~/.local/bin/).
Плюсы
pipx: каждое приложение изолировано, обновляется отдельно, не мусорит в системе.Вариант 3: Вернуться в "старый режим" (НЕ РЕКОМЕНДУЕТСЯ)
Если очень хочется вернуть всё "как раньше" (но рискуешь сломать систему), можешь запустить:
sudo pip install -U pip --break-system-packagesНЕ ДЕЛАЙ ЭТОГО НА ПРОДАКШЕН-СЕРВЕРАХ ИЛИ РАБОЧЕЙ ОС — это костыль.
Итог:
- Лучше используй
venvдля разработки (проекты, библиотеки). pipxдля прикладных программ (отдельные изолированные приложения).- Системные пакеты — через
apt:sudo apt install python3-XYZ.
Теперь ты в курсе современных best practices для Python на Linux!
P.S. Если совсем лень с
venvкаждый раз возиться, можешь сделать алиас (псевдоним) в~/.bashrc:alias venv='python3 -m venv .venv && source .venv/bin/activate'Тогда в новом проекте просто пишешь:
venv pip install ...Profit! 🎉
- Системный Python (тот, что установлен как часть ОС, например,
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.