📖 教程页帮助
本帮助介绍教程专用操作，帮助你顺利完成教程步骤。
📋 步骤导航
左侧步骤列表显示所有教程步骤：
- 选择步骤：点击任意步骤查看该步的学习目标、代码骨架和 API 参考。
- 步骤状态：已完成的步骤会显示绿色标记，当前步骤高亮显示。
- 学习目标：每个步骤开头说明本步要掌握的知识点。
- 代码骨架：需要完成的 C 代码模板，包含关键提示和占位符。
- API 引用：本步涉及的平台函数参考，可快速查看参数和用法。
📥 模板项目
教程使用预设的模板项目，帮助你快速开始：
- 默认模板：首次进入教程会加载默认的 main.c 模板，包含基本的 setup() 和 loop() 结构。
- 重置为骨架：点击"📥 重置为代码骨架"将当前文件恢复为空白骨架（会覆盖当前内容）。
- 重置本步：点击"🔄 重置本步"将当前文件恢复为本步的示例代码（会覆盖当前内容）。
- 撤销操作：点击"↩ 撤销"可恢复到上一次操作前的代码状态。
- 重新开始：编辑器“文件”菜单可重置当前默认文件、恢复当前步骤项目，或清除当前路线所有步骤的代码草稿。
⚠ 重置操作会覆盖当前文件内容，请确保已保存重要代码。
✅ 检查状态
教程提供代码检查功能，帮助你验证实现：
- 检查代码：点击"✅ 检查代码"运行本步的检查规则。
- 检查维度：包括代码结构检查（函数签名、必要语句）和运行时检查（编译、执行、行为）。
- 反馈信息：检查结果会显示在下方反馈区，绿色表示通过，黄色表示警告，红色表示未通过。
- 参考提示：检查失败时会提供具体的修改建议，帮助你定位问题。
💡 检查仅供参考，不会限制你的操作。你可以自由编辑代码。
🔄 重置本步
重置功能用于恢复教程代码：
- 重置为代码骨架：将当前文件恢复为空白模板，适合从头开始。
- 重置为本步示例：将当前文件恢复为本步的完整示例代码，适合查看参考实现。
- 撤销：撤销上一次的重置操作，恢复到操作前的状态。
- 影响范围：重置操作只影响教程项目，不会影响练习页的代码。
🔒 项目隔离
教程页与普通练习页的项目状态完全隔离：
- 独立存储：教程代码保存在
smartcar_tutorial_project，练习页保存在 smartcar_project。
- 互不干扰：在教程页重置、加载代码不会影响练习页；在练习页编辑不会影响教程。
- 独立运行：教程页和练习页可以同时打开，各自独立运行和调试。
- 返回练习：点击"↩ 练习"按钮可返回普通练习页。
🔒 固定 main.c 入口
教程页的运行入口固定为 main.c：
- 固定入口：无论你编辑哪个文件，点击"▶ 运行"始终执行 main.c。
- 切换文件：在文件列表中点击其他文件只改变编辑目标，不改变运行入口。
- 入口锁定：文件栏的"⭐ 主文件"按钮在教程页显示为"🔒"，表示入口已锁定。
- 多文件组织：你仍然可以创建多个文件，但运行时始终从 main.c 开始执行。
📁 多文件课基本操作
教程支持多文件组织，适合复杂项目：
- 创建文件：点击"＋ 新建"添加 .c 或 .h 文件，用于组织代码结构。
- 头文件包含：在 .c 文件中使用
#include "xxx.h" 引用头文件。
- 函数声明：在 .h 文件中声明函数，在 .c 文件中实现。
- 切换编辑：在文件列表中点击文件名切换编辑目标。
- 重命名/删除：使用"✏"重命名或"🗑"删除文件（main.c 不能删除）。
💡 多文件组织有助于代码模块化，推荐在复杂项目中使用。
▶️ 基本操作流程
教程学习的典型流程：
- 选择步骤：从左侧步骤列表选择要学习的步骤。
- 阅读目标：查看本步的学习目标和说明。
- 查看骨架：阅读代码骨架，了解需要完成的部分。
- 编写代码：在编辑器中编写或修改代码。
- 运行测试：点击"▶ 运行"执行代码，观察仿真效果。
- 检查验证：点击"✅ 检查代码"验证实现是否正确。
- 继续下一步：完成本步后，选择下一个步骤继续学习。
教程页专注于 API 学习和基础控制，不包含完整算法答案。如需深入学习，请参考相关课程资料。