插件装多了报错，适用边界到底该写在哪一行

上周三下午，插件测试组的装多同事发来一张截图：浏览器右上角弹出红色报错「Uncaught TypeError: Cannot read properties of undefined」，下面还压着一行小字「由插件 X 注入」。报错边界这张单子最初挂在我名下，适用我以为十分钟能关掉，到底结果拖到第二天中午才写清楚结论。该写复盘一遍，插件问题不在修 bug，装多而在没人说清这套插件组合到底管到哪一步。报错边界

14:10 先复现，适用别急着改代码

我做的到底第一件事不是打开编辑器，而是该写把报错码原样抄进记录：浏览器版本、插件版本、插件出问题的装多页面路径、触发动作（点「导出」按钮）。报错边界然后换一个干净的用户配置重跑一遍。干净配置下不报错，说明问题出在插件叠加，而不是页面本身。

这一步的边界很清楚：只确认「能不能稳定复现」，不猜原因。复现不了就先记下环境差异，别硬改。很多人这时候直接去翻源码，结果改了三处，报错换了张脸，反而更难定位。

15:30 二分停用，把范围缩到两个插件

插件冲突的排查，最省事的办法是二分。我先停掉一半插件，刷新，看报错还在不在；在就再停一半，不在就把刚才那批逐个加回来。三轮之后，范围缩到两个：一个负责表单校验，一个负责快捷键绑定。

单独开任何一个都不报错，同时开才炸。到这一步可以下判断：这不是某个插件写错了，是两者的执行时机撞了。此时我做的动作是记录「最小冲突组合」，而不是继续深挖源码——深挖的成本高，而且对使用方没有直接价值。

17:00 写适用边界，写成别人能照着做的句子

真正花时间的是这一步。我给每个受影响的插件补了一段适用边界说明，格式固定成三行：

第一行，适用环境：浏览器大版本、插件版本区间、页面类型。
第二行，不适用情形：与哪些插件同时启用会出问题，出问题的具体表现是什么。
第三行，替代路径：冲突时先停哪个、后停哪个，或者改用哪种等效操作。

写的时候有个原则：不写「建议谨慎使用」这类空话，写能对照的动作。比如「同时启用 A 与 B 时，点击导出会丢失一次提交；临时处理是先停 B，导出完成后再开」。这样的句子，下一个接手的人不用再复现一遍。

插件冲突怎样标注适用边界，关键不在措辞漂亮，而在把「什么时候不成立」提前写出来。只写「支持某某功能」的说明，等于把判断成本推给了用户。

次日 10:20 把说明放回触发点，再验一次

说明写完不算完。我把它放回两个位置：插件管理页的说明栏，以及报错出现的那条路径旁边的帮助入口。然后请同事按说明操作一遍，确认他能在不找我的情况下自己绕开。

验证的标准很朴素：他停用哪个插件、什么时候恢复，全程没再问人。做到了，这张单子才算关掉。做不到，说明边界写得还是太抽象，得回去改句子，而不是改代码。

这次失手的教训是：修得快不如边界写得清。插件组合会变，版本会升，唯一能留下来的是那几行「什么情况下别这么用」。下次再遇到类似报错，先问一句——这套组合的适用边界，上次写在哪一行了？