3、调试清单：高效解决软件问题的指南

调试清单：高效解决软件问题的指南

1. 调试的类比与心态

调试就如同《爱丽丝梦游仙境》中的冒险，充满了观察、好奇、实验和探索。然而，很多人并不享受调试过程，这源于调试的挫败感和常常令人尴尬的结果。实际上，大多数的 bug 都很“愚蠢”，解决后我们常懊恼自己为何会忽略。但换个角度看，这种感觉能让人保持谦逊，避免自负。

2. 文档的作用与局限

常有人说“5 小时调试不如 5 分钟读文档”，但这是错误的。
- 文档的问题 ：
- 很难在 5 分钟内读完有用的文档，除了一些简单工具的文档，但它们可能并非问题根源。
- 文档种类繁多，如系统、操作系统、语言、框架、工具等的文档，全部阅读既不实际也不一定相关。
- 文档不会直接指向 bug 或提供大致方向，而且错误和不完整的文档会浪费大量时间。
- 文档的价值 ：尽管文档不能替代调试，但它仍然非常有用。借助搜索引擎，在文档中搜索错误信息和相关关键词，能节省时间。在处理问题前，先检查是否已有解决方案或是否在故障排除部分。

3. 问题分类与游戏计划

在继续调试前，需要问自己以下问题：
- 问题在用户机器上是否可重现？
- 在自己机器上是否可重现？
- 是否一致？
- 是否是回归问题？

如果是回归问题且可重现，可使用 git bisect 来缩小问题首次出现的版本范围。若无法重现且未“看到” bug，可能是 bug 本身有误，外部因素（如用户机器上的插件）可能是原因，应将其列入假设列表。此