有效的排错记录不是“最后跑通了”，而是能让下一次更快找到原因。
记录模板
- 现象：实际看到了什么，保留原始错误文字。
- 预期：正确状态应该是什么。
- 范围：影响哪个页面、设备、版本或步骤。
- 假设：列出可能原因，并标明还未验证。
- 证据：每次检查支持或排除了什么。
- 修复：只改动与原因相关的最小范围。
- 回归验证：重新执行原路径，并检查相邻功能。
本项目的一个例子
知识库移动端首屏曾出现大面积空白。构建没有报错，但视觉截图显示正文延迟出现。进一步检查发现数学插件加载远程样式，阻塞了页面首屏；禁用未使用的插件后，页面不再依赖该远程资源，移动端首屏恢复正常。
相关：黑猫知识库建设记录。