pep 668引入了“外部管理环境”机制，旨在解决系统python与用户安装包之间的冲突。这导致用户无法再使用`pip install --user`直接安装包。本文将深入探讨这一变化，解释其背后的原因，并提供一套专业的解决方案，即利用`pyenv`等第三方工具来管理独立的python环境，从而恢复灵活的用户级包安装体验，确保系统稳定性和开发效率。
Python社区为了解决长期存在的系统级Python安装与用户自定义包之间冲突的问题，引入了PEP 668（"Marking Python environments as "externally managed""）。这一规范的核心思想是将由操作系统包管理器（如APT、YUM等）管理的Python环境标记为“外部管理”。这意味着在此类环境中，用户不应直接使用pip来安装或修改包，以避免与操作系统提供的Python包产生版本冲突或文件覆盖，从而可能破坏系统功能。
当尝试在受PEP 668保护的环境中执行pip install --user时，用户会遇到一个externally-managed-environment错误，并被提示创建虚拟环境或使用其他工具。以下是一个典型的错误示例：
$ 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.这个错误明确指出，为了安装非操作系统打包的Python包，建议使用虚拟环境（python3 -m venv）或pipx（用于应用程序）。虽然提供了--break-system-packages选项作为强制安装的手段，但官方强烈不推荐，因为它可能导致系统Python环境的损坏。
在PEP 668生效后，传统的pip install --user方法不再适用。虽然错误信息中提到了venv和pipx，但它们各有侧重：
立即学习“Python免费学习笔记（深入）”；
这两种方法都无法满足用户期望拥有一个独立于系统、且能全局默认使用的“用户本地Python环境”的需求。
为了在PEP 668时代恢复灵活的用户本地Python环境管理，并能够像过去一样自由地安装和使用Python包，最佳解决方案是采用第三方Python版本和环境管理工具，例如pyenv、conda或miniforge。这些工具通过安装独立的Python解释器，并将其与系统Python完全隔离，从而规避了PEP 668的限制。
以pyenv为例，它允许用户安装多个Python版本，并轻松地在这些版本之间切换，同时确保用户安装的包不会与系统Python冲突。
pyenv通过修改用户的PATH环境变量来管理Python版本。它在PATH的最前端插入了一个shims目录，其中包含指向pyenv管理的Python解释器和相关工具（如pip）的符号链接。当用户执行python或pip命令时，系统会首先找到pyenv的shims，然后由pyenv根据当前激活的Python版本来决定实际调用的解释器。
优势：
安装 pyenv: 可以通过git克隆到用户主目录，或使用安装脚本。推荐使用pyenv-installer脚本：
curl https://pyenv.run | bash
或者手动安装：
git clone https://github.com/pyenv/pyenv.git ~/.pyenv echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc echo 'eval "$(pyenv init --no-rehash)"' >> ~/.bashrc source ~/.bashrc # 或者 ~/.zshrc, 根据你的shell
安装完成后，请重启终端或执行source命令使配置生效。
安装Python依赖:pyenv编译Python版本需要一些系统依赖。以Ubuntu为例：
sudo apt update; sudo apt install -y build-essential libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev curl \ libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
安装一个Python版本: 选择你需要的Python版本，例如3.11.8：
pyenv install 3.11.8
这可能需要一些时间来下载和编译。
设置全局Python版本: 将新安装的Python版本设置为当前用户的默认版本：
pyenv global 3.11.8
你也可以使用pyenv local 3.11.8为特定项目目录设置版本。
验证 pip 路径: 现在，你的pip命令将指向pyenv管理的Python版本：
which python # 预期输出: /home/youruser/.pyenv/shims/python which pip # 预期输出: /home/youruser/.pyenv/shims/pip
这表明你现在使用的Python和pip是pyenv管理的，与系统Python完全分离。
安装包: 现在，你可以像过去一样自由地安装Python包，它们将安装到pyenv管理的Python环境中，不会影响系统：
pip install some-package
PEP 668的引入标志着Python包管理策略的一个重要转变，旨在提升系统稳定性和避免冲突。虽然这使得传统的pip install --user方式不再可行，但它也推动了更规范、更健壮的Python环境管理实践。通过采纳pyenv、conda或miniforge这类专业的第三方环境管理工具，开发者不仅能够完全规避PEP 668带来的限制，还能获得多版本管理、环境隔离和灵活切换的强大能力。这不仅恢复了用户在本地环境自由安装包的便利性，更提升了开发工作流的专业性和效率。在现代Python开发中，掌握并有效利用这些环境管理工具已成为一项不可或缺的技能。
以上就是PEP 668下Python用户环境管理及包安装最佳实践的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
607
收藏
