WSL 执行 pip install 出错：externally-managed-environment

WSL 执行 pip install 时，发生externally-managed-environment 错误：

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.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 错误的原因是你的操作系统或 Python 环境开启了 PEP 668 保护机制。即使你创建了新的 conda 虚拟环境，系统仍然标记该环境为“外部管理的”，不允许直接通过 pip 安装包。这是为了保护系统级的 Python 环境不被破坏。

解决方案：（推荐使用方案3）

1. 使用 --break-system-packages

你可以通过添加 --break-system-packages 参数强制 pip 安装包。这将绕过 PEP 668 保护机制，但要谨慎使用，因为可能会影响系统或虚拟环境的稳定性。

pip install pymilvus jina --break-system-packages

2. 使用 conda install 安装包

优先使用 conda 来安装包，这样不会触发 externally-managed-environment 错误。你可以尝试通过 conda-forge 频道来安装包：

conda install -c conda-forge pymilvus jina

3. 创建一个不受 PEP 668 管理的虚拟环境(推荐）

你可以通过 venv 创建一个完全独立于系统管理的虚拟环境。这样做可以避开 PEP 668 机制。

# 创建 venv 虚拟环境
python3 -m venv myenv# 激活虚拟环境
source myenv/bin/activate# 安装所需包
pip install pymilvus jina

总结

• conda 隔离方式：首先使用 conda-forge 来安装包。
• python venv 方式：使用 venv 创建完全隔离的虚拟环境来避开系统保护。
• 强制方式：使用 --break-system-packages 绕过保护机制。

转载自：

hint: See PEP 668 for the detailed specification.

https://blog.csdn.net/sunyuhua_keyboard/article/details/142098346