写在前面

航天器是一个极其庞大且复杂的系统，排查硬件或软件问题都极为困难。航天员在进入太空后，会依据一份详尽的检查清单逐项排查设备状态，该清单列举了各类可能出现的故障与应对步骤。在出现问题时，依清单逐步筛查，往往能快速定位并解决故障。

嵌入式的复杂程度虽不及航天系统，但在实际开发中，我们也常感到束手无策：每当打开电脑、连接硬件、准备开始“挑灯夜战”时，总会冒出各种意想不到的问题——可能是 Git 仓库异常、电机无故停转、串口无法读取数据，甚至程序卡在 HAL_Init()无法继续……

这些看似“细小”的问题，常常让我们狼狈不堪，尤其是在独立调试、缺乏经验参考时，摸索过程尤为煎熬。虽然踩坑是嵌入式开发的必经之路，但我们仍希望建立一个可供参照的排查指南，减少同辈与后来者重复遭遇类似的困境。

因此，我们创建了这份面向嵌入式的 Checklist。它是我们文档站规划已久的起点，也是开发团队高度重视的部分。目前该清单持续维护中，如果你在开发中遇到新的问题或解决方案，欢迎补充。