输入pip install pillow后显示error：externally-managed-environment

输入 pip install pillow 遇到错误：

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.

解决方案

这个错误是因为你在一个 externally managed environment（外部管理环境） 中尝试直接用 pip 安装包，而这个环境被你的系统（比如基于 Debian 的操作系统，如 Ubuntu）设置为受限制状态。这样设计是为了防止你意外破坏系统的全局 Python 环境。

这个限制是基于 PEP 668 的规范，确保系统的 Python 和包管理器（如 apt）之间不会发生冲突。

---

解决方法

根据你的需求选择一种解决方案：

1. 使用虚拟环境

推荐在虚拟环境中管理 Python 包，而不是直接修改全局环境：

python3 -m venv myenv
source myenv/bin/activate
pip install 包名

退出虚拟环境：

deactivate

2. 使用 pipx 安装独立的 Python 应用

pipx 会为每个工具创建一个独立的虚拟环境：

sudo apt install pipx
pipx install 包名

3. 全局安装，强制忽略限制（不推荐）

如果你确定自己知道在做什么，可以用 --break-system-packages 参数强制安装：

pip install 包名 --break-system-packages

警告：强制操作可能导致系统的 Python 环境出问题，影响到系统依赖的工具和功能。

4. 使用系统包管理器 apt 安装

如果目标库已经被打包为 Debian 系统包，可以直接用 apt：

sudo apt install python3-xyz

5. 检查 Python 环境

确保你正在用的 pip 对应的是正确的 Python 环境：

python3 -m pip install --user 包名

--user 参数只安装到当前用户目录，而不会影响系统全局环境。

---

总结

为了安全和长期维护，建议使用虚拟环境或 pipx，尽量避免直接修改系统的全局 Python 环境。

提示

也可以参考CSDN 文章1，CSDN 文章2