本文旨在探讨pep 668规范对linux发行版（如ubuntu 24.04）上用户python包管理的影响。由于系统python环境被标记为“外部管理”，传统的`pip install --user`命令不再适用。文章将解释这一变化的原因，并重点推荐使用`pyenv`、`conda`或`miniforge`等第三方工具来创建和管理独立的、用户友好的python环境，从而恢复便捷的包安装体验，并有效避免系统级冲突。
PEP 668与Python环境管理的变革
随着现代Linux发行版对Python的深度集成，系统预装的Python版本承载着大量系统工具和组件的依赖。为了避免用户自行安装的Python包与系统包之间产生冲突，导致系统功能受损，Python社区引入了PEP 668（“Marking Python environments as externally managed”）。这一规范的核心思想是将系统Python环境标记为“外部管理”，这意味着用户不应直接通过pip在该环境中安装或修改包。
当尝试在遵循PEP 668的系统上（例如Ubuntu 24.04）使用pip install --user安装包时，用户会遇到以下错误提示：
$ pip install setuptools --user
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.11/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.这个错误明确指出，当前环境由外部管理，并提供了几种替代方案：
- 使用系统包管理器（如apt）：适用于需要系统级安装且有对应发行版包的场景。
- 创建虚拟环境（venv）：这是推荐的针对特定项目的解决方案，但每次都需要激活。
- 使用pipx安装应用程序：pipx专为安装和运行Python应用程序而设计，它会为每个应用创建独立的虚拟环境。
尽管--break-system-packages选项可以强制安装，但其风险在于可能破坏系统Python安装，因此强烈不建议在生产或日常开发中使用。
立即学习“Python免费学习笔记（深入）”；
为什么内置方法不再满足用户需求？
PEP 668的引入，使得用户无法再像以前那样，通过pip install --user在全球范围内为当前用户安装Python包，并期望这些包能被默认的python或pip命令识别。虽然venv和pipx提供了项目级或应用级的隔离，但它们未能解决用户希望拥有一个“全局”的、可自由安装包的个人Python环境的需求，而这个环境又独立于系统Python。用户仍然希望能够便捷地使用最新版本的pip和各种Python包，而不必每次都激活虚拟环境。
推荐解决方案：第三方Python环境管理工具
面对PEP 668带来的新挑战，最有效且推荐的解决方案是采用第三方Python环境管理工具。这些工具能够创建完全独立于系统Python的Python安装，并允许用户自由管理其包依赖。其中，pyenv、conda（或其轻量级版本miniforge）是广受欢迎的选择。
以Pyenv为例：构建用户独立的Python环境
pyenv是一个强大的Python版本管理工具，它允许用户在同一台机器上安装和管理多个Python版本，并能轻松切换。其核心优势在于：
- 完全独立性：pyenv安装的Python版本及其pip是完全独立于系统Python的。
- 版本切换：用户可以根据需要，在全球范围、目录范围或shell会话中切换Python版本。
- 便捷的包管理：在pyenv管理的Python环境中，用户可以像PEP 668之前那样，直接使用pip install <package>来安装包，无需担心系统冲突。
Pyenv基本使用流程：
-
安装pyenv：通常通过curl脚本或包管理器安装，并配置shell环境。
# 安装pyenv及其插件 curl https://pyenv.run | bash # 将pyenv初始化脚本添加到shell配置文件（如~/.bashrc或~/.zshrc） echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc echo 'eval "$(pyenv init --no-rehash -)"' >> ~/.bashrc echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc source ~/.bashrc # 或 source ~/.zshrc
-
安装Python版本：
pyenv install 3.11.8 # 安装一个特定的Python版本
-
设置全局或局部Python版本：
pyenv global 3.11.8 # 设置为当前用户默认的Python版本 # 或者 # cd my_project_directory # pyenv local 3.11.8 # 为当前目录设置Python版本
-
验证pip路径：设置完成后，pyenv会通过修改PATH环境变量，确保pyenv管理的Python和pip优先被调用。
$ where pip /home/john/.pyenv/shims/pip # pyenv管理的pip /home/john/.local/bin/pip /usr/local/bin/pip /usr/bin/pip /bin/pip
从上述输出可以看出，pyenv的shims目录下的pip路径位于最前面，这意味着当你执行pip命令时，实际上调用的是pyenv管理的Python环境中的pip。
至此，用户便可以在这个由pyenv管理的独立环境中，像往常一样使用pip install xxx来安装和管理Python包，而无需担忧与系统Python环境的冲突。
其他替代方案：Conda/Miniforge
conda（或更轻量级的miniforge）是另一个强大的环境和包管理器，尤其在科学计算领域广受欢迎。它不仅能管理Python版本，还能管理非Python语言的包和依赖。其工作原理与pyenv类似，都是通过创建独立的、隔离的环境来避免冲突。
总结与最佳实践
PEP 668的实施是Linux发行版维护系统稳定性的重要举措。虽然它改变了用户习惯的Python包安装方式，但也促使我们采用更健壮、更专业的环境管理策略。对于希望拥有一个可自由安装包的个人Python环境的用户而言，依赖pyenv、conda或miniforge等第三方工具是当前最推荐且最有效的解决方案。它们提供了：
- 环境隔离：彻底将用户开发环境与系统环境分离。
- 版本控制：轻松管理和切换不同Python版本。
- 无忧安装：在独立环境中自由安装任何Python包，避免系统冲突。
通过采纳这些工具，用户不仅能恢复便捷的开发体验，还能确保系统的稳定性和安全性，实现Python环境管理的现代化和规范化。
