#常见报错与求助指南

遇到报错别慌——这很正常，人人都会遇到。这一页教你排错的思路和如何高效求助。各章末尾还有针对该章的"常见报错 FAQ"，本页则是通用总纲，会随课程不断补充。

#排错三步法

1. 看清报错的最后几行：错误信息通常"最后一句"最关键，先读它，再往上看。
2. 定位是哪一类问题（见下表），对症下药。
3. 缩小范围：把"改动"一点点回退，看是哪一步引入的问题。

#常见问题分类

#善用这些"自查"工具

• dora doctor：一键系统诊断。
• dora validate dataflow.yml：检查数据流配置对不对。
• 确认 Rust 工具链和 Python 环境是否就绪。
• 确认 DORA 是否正确编译（dora --version）。
• 查看终端输出中的错误信息。

#如何高效求助

在 DORA 中文社区 提问时，附上这些信息能让别人更快帮到你：

1. 你的环境：操作系统（Windows/macOS/Linux）、DORA 版本。
2. 你在做什么：第几章、哪一步、想达到什么。
3. 完整报错：把报错从头到尾复制出来（别只截最后一行）。
4. 你已经试过什么：这能避免别人重复建议。