知识卡片

普通读书笔记卡

最短距离与最小范围原则

理解等级:未标注

可调试性设计里两条互补的原则,分别对应”什么时候检查错误”和”检查出错误后报告得有多精确”两个 维度。最短距离原则要求错误检查代码尽可能贴近可能失败的操作本身:一个 Init 方法调用 Load 方法读配置文件,如果 Load 读取失败却没有及时检查、”成功”返回,等到 Init 用了没被正确 初始化的成员变量才出错,这时”第一现场”——真正的失败点——已经被错过了,调试者看到的报错位置 和真正病因之间隔了好几层调用,定位难度大增。解法很直接:哪里可能失败,就在哪里立刻检查,不要 把检查往后拖延。最小范围原则要求错误报告或调试信息能精确定位到尽可能小的范围,而不是笼统地 说”error”或”abnormal”——书中举了 BIOS 的 Post Code 机制作为范例:为不同代码块精心编排不同的 整数代码,一旦启动失败,只看最后一个 Post Code 值就能推测出大致是哪个阶段、哪类错误,而不需要 反向猜测。对于用文字报错的场景,同样的原则要求让不同来源的错误描述能相互区分(”信息唯一性”), 如果十个不同函数产生的错误信息长得一模一样,报错信息本身就失去了缩小排查范围的作用。这两条原则 合起来说的是同一件事:调试信息的价值取决于它离真相有多近、指向有多精确,而不是有没有报错。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《软件调试(第2版)卷1:硬件基础》第15章《可调试性概览》15.3.1/15.3.2节(源文件:_epub-src/OEBPS/text00026.html) - 结论依据:原文定义最短距离原则"使错误检查代码距离失败操作的距离最短"并用Load方法未及时检查失败的例子说明"错误的第一现场被错过了,这会增加调试的难度";最小范围原则"使错误报告或调试信息所能定位到的范围尽可能小"并以BIOS Post Code为例说明如何通过精确编码缩小排查范围,因此可以推出本卡片对两条原则的结论。 - 原始内容:最短距离原则是指使错误检查代码距离失败操作的距离最短……对于这样的情况,错误的第一现场被错过了,这会增加调试的难度。最小范围原则是指使错误报告或调试信息所能定位到的范围尽可能小……这样便有利于通过Post Code值反向追溯到相关的代码。