装完才发现版本对不上，返工那晚我理出的先后次序

上周三晚上十点，装完我帮同事在一台离线电脑上装一套设计插件。现版序装完打开主程序，本对不上弹窗提示“宿主版本不兼容”。返工我以为重装一遍就好，那晚结果卸了装、理出装了卸，后次折腾四十分钟，装完最后发现是现版序主程序本身停留在两年前的版本，插件却是本对不上按新接口写的。那天真正该先做的返工，是那晚把两边版本号摊在一张纸上比一遍，而不是理出急着点“下一步”。事后我按时间顺序把这次失手复盘了一遍，后次每一步对应一个动作，装完顺序不能颠倒。

先看报错原文，别急着动手卸载

那天我一看到弹窗就点关闭，凭印象判断是“装错了”。正确做法是先把报错原文完整抄下来，或者直接截图。报错里通常藏着三个信息：哪一方在报错（宿主、插件还是运行库）、它期望的版本范围、以及它实际检测到的版本。这三个信息决定了后面先查谁。

我后来在另一台机器上重演，发现报错写的是“requires 4.x, found 2.6”。这就很明确：不是插件坏了，是宿主太旧。如果当时我先抄下这句话，直接去查宿主的版本记录，就能省掉后面两次卸载。判断标准很简单——报错里出现“requires”“expected”“found”这类词，说明冲突点在版本区间，而不是文件损坏或权限问题。软件版本对不上怎么排优先级，第一优先级永远是先把“谁嫌弃谁”读清楚。

把宿主、插件、运行库分成三栏核对

光看报错还不够，容易漏掉隐藏的一层。那天我只盯着插件和宿主，忽略了插件依赖的一个运行库，它又是另一个版本线。正确顺序是列三栏：宿主程序版本、插件自身版本、以及插件依赖的运行库版本。每栏写两行——当前装的是什么、对方要求的是什么。

核对时有个容易犯的错：把“最新版”当成“兼容版”。我那台离线机没法联网更新，最新版反而要求更高的宿主。所以第三栏还要加一句：这台机器能不能升级、升级要不要联网或审批。如果宿主受管控不能动，那优先级就落在找一个匹配旧宿主的插件版本上，而不是硬升宿主。这一步花十分钟，能省掉后面一小时的来回装。

按“改动成本”决定先动哪一边

三栏摆出来后，冲突往往不止一处，这时才轮到排优先级。我的排序依据是改动成本，从低到高：先动插件版本（通常一个安装包就能换），再动运行库（影响面小），最后才动宿主主程序（可能牵动其他插件和项目文件）。

那天我顺序反了，先动了宿主，结果另外两个正常工作的插件也跟着报警。教训是：动宿主之前，先确认它下面还挂着哪些依赖。如果宿主是团队统一管控的，那它根本不该进你的改动清单，直接去找匹配当前宿主的插件版本。软件版本对不上怎么排优先级，本质就是一句话——谁改动代价小、影响面窄，谁先动；牵一发动全身的那一方，留到最后并提前备份。

改完先跑一个最小用例，再回主流程

最后一次装好，我没有立刻打开正式项目，而是新建了一个空白文件，只调用插件最基本的一个功能。能正常出结果，再回到原来的项目文件。这一步是给自己留退路：最小用例失败，说明版本组合还是不对，损失可控；直接开正式文件，一旦保存出问题，回滚就麻烦了。

顺手把这次的三栏版本号和报错原文记在安装目录下的一个文本文件里。下次再遇到同类提示，先翻这份记录，比重新猜一遍快得多。版本冲突不是靠运气解决的，是靠把“谁要求谁、谁改动便宜”这两件事按顺序写清楚。那晚多花的四十分钟，换来的是这套顺序，值。