科技 · 实用指南
pip 提示 externally managed？先判断安装目标，别急着强制覆盖
先证明解释器、标记与包所有者，再在发行版包、venv、pipx 或受控覆盖之间选择。
先证明解释器、标记与包所有者，再在发行版包、venv、pipx 或受控覆盖之间选择。
这条拒绝说明当前 Python 由另一套包管理器负责，并不代表所有 pip 安装都不可能；安全答案取决于安装对象及其真正所有者。
固定解释器与完整错误
先保存完整报错、命令、目标包和运行环境；用 python3 -m pip --version，并记录 Python 路径、sys.executable、sys.prefix、sys.base_prefix 与标准库目录。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
不要先删 EXTERNALLY-MANAGED、升级系统 pip 或写入永久覆盖；同时保存 pip config debug 与相关环境变量。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
先判断要安装的是什么
项目库放入项目虚拟环境；独立命令优先 pipx；系统组件优先发行版包；完全受控的镜像或设备另行处理。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
同一个包既可能是库、命令、系统依赖或镜像输入，角色不同，安全工具和回滚方式也不同。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
核对标记与所有者
规范要求同时检查是否在虚拟环境外，以及标准库目录是否存在 EXTERNALLY-MANAGED；必须检查实际 sysconfig 路径。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
若 marker 属于基础解释器，就把系统发行版视为所有者；删除文件不会改变所有权、更新策略或回滚责任。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
项目库使用 venv
从目标解释器创建 .venv，并用环境内的 python -m pip 安装；先确认 Python 与 pip 都指向该目录。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
虚拟环境默认隔离、可删除并重建；记录 requirements 或锁文件，不把 .venv 当成唯一数据。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
命令用 pipx，系统需求用发行版包
独立 Python 应用优先用 pipx 管理独立环境；操作系统或服务需要的组件优先 apt、dnf、pacman、brew 等原所有者。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
pip --user 不是通用绕过，因为用户目录包仍可能影响基础解释器的导入路径。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
覆盖只用于受控例外
--break-system-packages 明确允许修改受外部管理的解释器，这是一项风险许可，不是默认建议。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
只有能控制完整环境、可重建并有回滚时才考虑；不要写成全局配置，也不要为让自动化变绿而删 marker。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
验证导入、所有权与回滚
重新完成原目标，并记录解释器、pip、prefix、导入位置或命令路径；镜像应从干净基础重建。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
成功修复应保持基础解释器标记与发行版数据库一致，同时让项目依赖可重现且没有隐藏全局覆盖。 请把本分支的实际路径、包所有者证据和回滚方法一并记录，验证后再进入下一步。
