使用评论块

Using Comment Blocks

本教程将介绍如何在 VEXcode GO 中使用注释块。学完本教程后，您将了解为什么要使用注释来记录项目以及如何使用注释。

注释模块允许您直接在模块堆栈中添加注释，这些模块位于工具箱的逻辑 - 注释类别中。它们不会影响项目的运行方式，只是为了帮助您和其他人理解项目。

默认的评论块如下所示（启动时显示）。

当开始 :: hat events
[comment]

程序员使用注释来组织代码，使其更易于阅读和理解，这不仅方便自己日后回顾项目，也方便其他开发人员理解。单个代码块的名称只能描述该代码块本身，而注释可以一次性描述整个代码块组的行为——这样，你就可以一目了然地了解一组代码块的作用，而无需逐个阅读每个代码块。

例如，这个项目会一直向前推进，直到遇到障碍物，然后停止。要理解这一点，需要逐个阅读代码块。

一个一路向前，直到撞到什么东西，然后就停下来的项目。

当开始 :: hat events
驱动 [向前 v]
等到 <[bumper v] pressed? :: custom-led :: custom-led>
驱动停止
驱动 [反 v] (100) [毫米 v] ▶

在每个部分上方添加注释来描述其行为，使项目更容易一目了然。

同一个项目，每个部分都附有注释，描述其行为。

当开始 :: hat events
[Drive forward until something is in the way.]
驱动 [向前 v]
等到 <[bumper v] pressed? :: custom-led :: custom-led>
[Back away from the object.]
驱动停止
驱动 [反 v] (100) [毫米 v] ▶

将机器人连接到connecting-to-your-robot.md后，选择“开始”运行项目。机器人将向前行驶，遇到障碍物时停止并后退。