Ubuntu 24.04 在运行 pip install 时出现如下错误:
pip install -e .
error: externally-managed-environment× This environment is externally managed
╰─> To install Python packages system-wide, try apt installpython3-xyz, where xyz is the package you are trying toinstall.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. Makesure 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 avirtual environment for you. Make sure you have pipx installed.See /usr/share/doc/python3.12/README.venv for more information.
这并非故障,而是系统为了保护 Python 环境稳定性(依据PEP 668标准)而设置的保护机制。
其目的是防止你通过 pip 安装的包与系统包管理器 apt 安装的包发生冲突,从而避免破坏系统功能。
推荐使用虚拟环境解决
这是 Python 开发的标准做法,能为每个项目创建独立的包安装空间,与系统完全隔离。
- 确保已安装 venv 模块
apt update
apt install python3-venv
- 进入你的项目目录,创建虚拟环境(环境文件夹通常命名为 .venv 或 venv)
python3 -m venv .venv
- 激活虚拟环境
source .venv/bin/activate
- 现在可以在虚拟环境中安全使用 pip 安装任何包
pip install <包名>
- 工作完成后,退出虚拟环境
deactivate