# 注释

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

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

```bt
// 计算用户本次订单总价
total = price * count
```

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

```bt
/*
这里先校验用户是否登录。
后续如果接入权限系统，可以在这里增加角色判断。
*/
if !user_id {
    return '未登录'
}
```

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