使用評論區塊

Using Comment Blocks

本教學將介紹如何在 VEXcode GO 中使用註解區塊。學完本教學後，您將了解為什麼要使用註釋來記錄項目以及如何使用註釋。

註釋模組可讓您直接在模組堆疊中新增註釋，這些模組位於工具箱的邏輯 - 註釋類別中。它們不會影響專案的運作方式，只是為了幫助您和其他人理解專案。

預設的評論區塊如下所示（啟動時顯示）。

當開始時 :: hat events
[comment]

程式設計師使用註解來組織程式碼，使其更易於閱讀和理解，這不僅方便自己日後回顧項目，也方便其他開發人員理解。單一程式碼區塊的名稱只能描述該程式碼區塊本身，而註解可以一次描述整個程式碼區塊組的行為－這樣，你就可以一目了然地了解一組程式碼區塊的作用，而無需逐一閱讀每個程式碼區塊。

例如，這個專案會一直向前推進，直到遇到障礙物，然後停止。要理解這一點，需要逐一閱讀程式碼區塊。

一個一路向前，直到撞到東西，然後就退縮的項目。

當開始時 :: hat events
行駛 [前方 v]
等待直到 <[bumper v] 按下？ :: custom-led>
停止行駛
行駛 [反向 v] (100) [mm v] ▶

在每個部分上方添加註釋來描述其行為，使項目更容易一目了然。

同一個項目，每個部分都附有註釋，描述其行為。

當開始時 :: hat events
[Drive forward until something is in the way.]
行駛 [前方 v]
等待直到 <[bumper v] 按下？ :: custom-led>
[Back away from the object.]
停止行駛
行駛 [反向 v] (100) [mm v] ▶

After connecting your robot to VEXcode, select Start to run the project. The robot will drive forward, stop and back away once it bumps into something.