# BT.env

## 功能

读取当前有效环境变量。

## 语法

```bt
BT.env(name)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| name | String | 是 | 无 | 环境变量名。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| String/Empty | 变量存在时返回字符串；不存在或被 BT overlay 删除标记遮蔽时返回 empty。 |

## 示例

```bt
BT.set_env('BT_MODE', 'dev')
result = BT.env('BT_MODE')

// 输出：dev
print result
```

## 注意事项

- 读取时先查 BT 运行期环境变量 overlay，再回退到 OS 环境变量。
- 环境变量名为空时会报错。