# BT.remove_env

## 功能

删除 BT 运行期环境变量，并遮蔽同名 OS 环境变量。

## 语法

```bt
BT.remove_env(name)
```

## 参数

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

## 返回值

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

## 示例

```bt
BT.set_env('BT_MODE', 'dev')
old = BT.remove_env('BT_MODE')

// 输出：dev
print old
```

## 注意事项

- remove_env 会写入删除标记，使后续 BT.env(name) 返回 empty。
- 该操作不删除操作系统永久环境变量。