唯一推荐解法是创建并激活虚拟环境：python3 -m venv myenv，source myenv/bin/activate，再pip install；系统Python受PEP 668保护，禁止直接pip安装，硬用--break-system-packages可能破坏apt依赖。

直接用虚拟环境，别碰系统 Python

Debian 12+（包括 Ubuntu 22.04/24.04、WSL2 默认环境）报 error: externally-managed-environment，不是 pip 坏了，是系统故意拦你——它通过 pyvenv.cfg 里的 externally-managed = true 告诉 pip：“这环境归 apt 管，你别动”。硬加 --break-system-packages 可能搞崩 apt 依赖，比如某天 sudo apt upgrade 突然失败，或者 gnome-control-center 启不起来。

为什么不能直接 pip install？

• Debian 把系统 Python 当作“基础设施”，所有 apt install python3-* 包都依赖同一套 site-packages
• 你用 pip 往里塞一个新版 requests，可能让 apt 自带的 apt-listchanges 或 unattended-upgrades 崩掉
• PEP 668 是正式规范，不是临时补丁，2026 年所有主流发行版都已强制启用

创建并激活 venv 是唯一推荐路径

• 不需要 sudo，不污染系统，项目之间互不干扰
• 所有现代 Python（3.3+）都自带 venv 模块，不用额外装

python3 -m venv ~/myproj-env
source ~/myproj-env/bin/activate
pip install --upgrade pip
pip install langchain fastapi

常见卡点与绕过方式

• PIP_REQUIRE_VIRTUALENV 环境变量设为非空值时，pip 会拒绝执行——运行 unset PIP_REQUIRE_VIRTUALENV 再试
• 如果 source 报错 “No such file or directory”，说明没成功创建 venv，检查是否漏了 python3 -m venv 步骤，或磁盘满/权限不足
• python3 -m pip install xxx 在系统环境下依然会报错，因为 python3 -m pip 还是调的系统 pip，不是解法
• apt install python3-xxx 只适用于极少数基础库（如 python3-tk、python3-venv），绝大多数 AI/DevOps 包（langchain、streamlit、rosdepc）根本不在 apt 仓库里

pipx 是第二选择，但只适合 CLI 工具

• 它自动为每个命令行工具建隔离环境，适合 black、poetry、pylint
• 不适合 Web 项目或需要多包协同的场景（比如你不能用 pipx 装 fastapi + uvicorn + pydantic 然后跑服务）
• 安装方式：sudo apt install pipx → pipx ensurepath → pipx install streamlit

真正容易被忽略的一点：很多人在 ~/.bashrc 里加了自动激活某个 venv 的逻辑，结果一开终端就进错环境，后续所有 pip install 都看似正常，实则装到别人项目里去了。确认当前环境是否干净，最简单的办法是看 shell 提示符有没有 (xxx)，再执行 which python 和 which pip —— 两者路径必须一致，且都指向 venv 子目录。