「装不上就重装」之前，先看四种「装不上」各要多少代价
「装不上就重装环境」在大多数情况下是白做的。四种「装不上」代价完全不同：真正装不上（红字依赖冲突）重装有效；装成功但程序看不见（装错环境）重装完全无效，修复成本只要一条 pip -V；只有某个功能报缺包是可选依赖缺失，单独装那一个；换机器才报错才轮到重装。判定「该不该重装」只有一行：装包时是否失败。
排错重装依赖管理Python环境决策表这条适用于
- 装包动作（要能区分「装的时候就报错」与「装成功但程序看不见」）
- 机器上存在多个 Python 或 venv
版本指纹
Windows 11 + RTX 5090D；2026-10-01 本机环境拓扑
具体做法
表一：四种「装不上」，代价完全不一样
| 症状 | 真实原因 | 重装能解决吗 | 实际修复成本 |
|---|---|---|---|
| 装的时候报错（红字、依赖冲突） | 真的装不上 | ✓ 能 | 几十分钟 |
| 装成功、import 通、程序说没有 | 装进了另一个环境 | ✗ 完全不能 | 一条 pip -V |
| 只有某个功能报缺包 | 该功能的可选依赖没装 | ✗ 不能 | 装那一个包 |
| 换了台机器就报错 | 环境没跟着走 | △ 重装是正解 | 几小时（先固定版本） |
本机实际花了一天半，而第二行的修复成本是一条命令 —— 这个反差就是本表存在的理由。
表二：自检该看哪里（不要看「有没有报错」）
<python.exe> -m pip -V 看末尾括号里的解释器路径 与程序一致 -> ✓
<程序python.exe> -c "import 包; print(包.__file__)" 看 __file__ 路径前缀 在程序环境 -> ✓
# 实测：pip 的反馈全部来自一个与程序无关的环境
$ pip install onnxruntime
# Successfully installed onnxruntime-1.24.1 <- 没有红字，退出码 0
$ python -c "import onnxruntime; print('OK')"
# OK <- 也真的通过
$ python -m pip -V
# ... (python 3.13) <- 括号里是 3.13，而 ComfyUI 跑在 3.12
# 两处都是真话 —— 它们只是在说另一套环境的事。表三：把你的情况往里对
| 装包无报错、程序报 ModuleNotFoundError | -> 别重装，先跑 pip -V |
|---|---|
| 装包时就报冲突、红字一片 | -> 可以重装，但先导出依赖清单固定版本 |
| 只有某个功能报缺包 | -> 别重装，单独装那一个 |
| 机器上有两个以上 Python | -> 别重装，先列清单，搞清哪个是程序在用的 |
| 换了机器才报错 | -> 重装合理，但把版本写进文件 |
一句实话：重装之所以被反复推荐，不只因为省力气，还因为它让你停止思考。
失效边界
适用边界：本表为 2026-10-01 本机（Windows 11 + RTX 5090D）实测的经验总结，不是通用规范，不同安装顺序与操作系统下环境拓扑会变；表中「修复成本」为量级估计，非精确工时。但一条判据通用：装包动作是否失败，是「该不该重装」唯一值得花时间的分界线；「装成功但程序看不见」这类问题，重装永远无效。
适用边界：本表为 2026-10-01 本机（Windows 11 + RTX 5090D）实测的经验总结，不是通用规范，不同安装顺序与操作系统下环境拓扑会变；表中「修复成本」为量级估计，非精确工时。但一条判据通用：装包动作是否失败，是「该不该重装」唯一值得花时间的分界线；「装成功但程序看不见」这类问题，重装永远无效。