Ubuntu 24.04 运行 pip install 报 externally-managed-environment

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 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.

这并非故障，而是系统为了保护 Python 环境稳定性（依据PEP 668标准）而设置的保护机制。

其目的是防止你通过 pip 安装的包与系统包管理器 apt 安装的包发生冲突，从而避免破坏系统功能。

推荐使用虚拟环境解决

这是 Python 开发的标准做法，能为每个项目创建独立的包安装空间，与系统完全隔离。

1. 确保已安装 venv 模块

apt update

apt install python3-venv

2. 进入你的项目目录，创建虚拟环境（环境文件夹通常命名为 .venv 或 venv）

python3 -m venv .venv

3. 激活虚拟环境

source .venv/bin/activate

4. 现在可以在虚拟环境中安全使用 pip 安装任何包

pip install <包名>

5. 工作完成后，退出虚拟环境

deactivate