注释

功能

注释是写给人看的说明文字，解释代码为什么这样写、某段逻辑的边界是什么，或临时记录需要注意的事项。BT 运行代码时会忽略注释，注释不会产生变量、返回值或运行时开销。

单行注释

单行注释从 // 开始，到当前行结束为止。适合解释一行代码、标记一个短说明，或在调试时临时关闭一行代码。

多行注释

多行注释从 /* 开始，到 */ 结束。适合说明一段算法、接口约定、配置块，或临时关闭多行代码。

使用建议

• 写“为什么”，少写代码已经能直接看出的“做了什么”。
• 单行说明用 //，跨多行说明或大段临时屏蔽用 /* ... */。
• 注释应跟代码保持同步；过期注释比没有注释更容易误导读者。