# BT.set_env

## 功能

写入 BT 运行期环境变量覆盖层。

## 语法

```bt
BT.set_env(name, value)
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| name | String | 是 | 无 | 环境变量名。 |
| value | Any | 否 | '' | 环境变量值，写入前转为字符串。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| String/Empty | 返回写入前的有效值；原本不存在时返回 empty。 |

## 示例

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

// 输出：dev
print result
```

## 注意事项

- BT.set_env() 只修改 BT 运行期 overlay，不调用系统全局环境变量写入。
- 同名变量原本有删除标记时，set_env 会覆盖删除标记。