问题回顾:安装 Python 时遇到的 externally-managed-environment 错误
在 Ubuntu/Debian 系统上执行以下命令时:
bash
sudo apt-get install python3-pip
python3 -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
报错信息:
text
error: externally-managed-environment
错误原因
从 Ubuntu 23.04+ 和 Debian 12+ 开始,Python 默认启用 externally-managed-environment 保护机制,禁止直接使用 pip 全局安装 Python 包。
这是为了避免用户通过 pip 安装的包与系统 apt 管理的包发生冲突,导致依赖混乱。
正确解决方法
✅ 方法 1:使用 apt 升级 pip(推荐)
bash
sudo apt update
sudo apt install --only-upgrade python3-pip
优点:
- 完全遵循系统包管理规范,避免破坏 Python 环境。
- 无需额外配置,安全可靠。
验证是否升级成功:
bash
pip --version