技术实践 / 随录小笺
从一个可以验证的小步骤开始
把复杂问题拆小,让每一步都有可观察的结果。
先描述现象
排查技术问题时,先记录实际发生了什么、期望发生什么,以及触发问题的条件。版本、输入和必要的环境信息有助于复现,但记录中应去掉密码、令牌和无关的个人信息。
一次验证一个假设
先选择影响范围较小的检查。如果怀疑输入有误,就核对输入;如果怀疑某个环节失败,就观察该环节的结果。一次改变太多条件,会让结果难以解释。
把过程留给后来者
完成调整后,重新执行相同的检查,并确认相关功能仍然正常。保存必要的操作说明、结果和恢复方法,让下一次遇到问题时可以从已有证据继续。
能复现、能验证,也能解释为什么。