# 错误：外部管理的环境

× 此环境由外部管理
╰─> 若要在系统范围安装 Python 包，请尝试 apt install python3-xyz，其中 xyz 是您尝试安装的包。

- **ID:** `python/pip-externally-managed-environment`
- **领域:** python
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

PEP 668 标记文件（EXTERNALLY-MANAGED）存在于系统 Python 的 stdlib 中，告诉 pip 不要修改操作系统管理的解释器。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **** (98% 成功率)
   ```
   python3 -m venv .venv
source .venv/bin/activate
python -m pip install requests
   ```
2. **** (92% 成功率)
   ```
   sudo apt install python3-requests
# or for CLI apps
pipx install ruff
   ```

## 无效尝试

- **** — --user still writes into the externally-managed interpreter's user site-packages and is blocked. (90% 失败率)
- **** — Running as root does not bypass the PEP 668 marker and can corrupt OS packages. (95% 失败率)