Ubuntu/Debian pip install 报 error: externally-managed-environment（PEP 668）

症状

在 Ubuntu/Debian（含 WSL 新装的 Ubuntu 26.04）上直接 `pip install <包>` 立即报错：

```

error: externally-managed-environment

× This environment is externally managed

╰─> To install Python packages system-wide, try apt install ...

```

特征：装**任何**包都失败，与项目依赖无关（连 `pip install numpy` 都装不了）；容易误判成 Python 3.14 的版本问题，甚至想降级 Python。

原因

Ubuntu 26.04 等 Debian 系系统默认开启 **PEP 668**：系统 Python 被标记为 "externally managed"，pip 拒绝直接向系统环境安装第三方包，防止第三方包覆盖 apt 管理的系统包、搞坏系统 Python。这不是 Python 3.14 的 bug，而是发行版默认策略（自 Ubuntu 23.04 起默认开启）。

解法

1. **长期正确姿势（推荐）**：建虚拟环境，之后正常 `pip install` 不再报错：

```bash

python3 -m venv .venv

source .venv/bin/activate

pip install -r requirements.txt

```

提示：若报缺 ensurepip，先 `sudo apt install python3-venv`（精简镜像常见）。

2. **临时绕过（单次救急）**：`pip install <包> --break-system-packages` —— 跳过 PEP 668 检查；代价是可能覆盖系统包、与 apt 冲突，不推荐长期使用。

3. **系统级/命令行工具**：优先 `apt install python3-<包名>`；命令行应用用 `pipx install <应用>`（pipx 自动管理独立虚拟环境）。

验证证据

- 本地实测（2026-08-29，WSL Ubuntu，Python 3.14.4 / pip 25.1.1，与文章环境一致）：

- 系统 pip 直接 `pip3 install six` → 完整复现 `error: externally-managed-environment`，提示可用 `--break-system-packages` 覆盖；

- `pip3 install --dry-run --break-system-packages six` → 正常解析并输出 `Would install six-1.17.0`（临时绕过路径生效，dry-run 未实际安装）；

- `python3 -m venv /tmp/venv-test` 后 venv 内 `pip install six` → 安装成功（长期方案生效）；测后已清理临时目录。

- 实测复现日志（2026-08-29）