# BT 运行时信息

## 功能

BT 是全局只读静态对象，用于读取当前解释器版本、平台、运行期快照、环境变量覆盖层、PATH 条目和内置能力表。

## 语法

```bt
BT.VERSION
BT.info()
BT.env('PATH')
BT.has('process')
```

## API 列表

| API | 说明 |
| ------ | ------ |
| [BT 常量](/zh-hans/docs/bt/constants) | 读取 VERSION、NAME、OS、ARCH、FAMILY、DEBUG、EXE_EXT、LIB_EXT、POINTER_WIDTH、THREADS。 |
| [BT.info](/zh-hans/docs/bt/info) | 返回当前运行时信息快照。 |
| [BT.env](/zh-hans/docs/bt/env) | 读取有效环境变量。 |
| [BT.set_env](/zh-hans/docs/bt/set_env) | 写入 BT 运行期环境变量覆盖层。 |
| [BT.remove_env](/zh-hans/docs/bt/remove_env) | 删除运行期环境变量并遮蔽同名 OS 环境变量。 |
| [BT.has_env](/zh-hans/docs/bt/has_env) | 判断当前有效环境变量是否存在。 |
| [BT.envs](/zh-hans/docs/bt/envs) | 返回合并后的有效环境变量对象。 |
| [BT.path_entries](/zh-hans/docs/bt/path_entries) | 返回当前有效 PATH 条目列表。 |
| [BT.add_path](/zh-hans/docs/bt/add_path) | 向有效 PATH 追加或前置路径。 |
| [BT.remove_path](/zh-hans/docs/bt/remove_path) | 从有效 PATH 删除路径。 |
| [BT.has_path](/zh-hans/docs/bt/has_path) | 判断有效 PATH 是否包含路径。 |
| [BT.system](/zh-hans/docs/bt/system) | 返回轻量系统字段。 |
| [BT.runtime](/zh-hans/docs/bt/runtime) | 返回运行期 uptime、threads、start_time。 |
| [BT.stats](/zh-hans/docs/bt/stats) | 返回 I/O、task、timer、net、FFI 和缓存资源统计。 |
| [BT.has](/zh-hans/docs/bt/has) | 判断当前解释器是否内置某项能力。 |
| [BT.features](/zh-hans/docs/bt/features) | 返回当前解释器能力表。 |
| [BT.runtime_id](/zh-hans/docs/bt/runtime_id) | 返回当前 BT 进程运行实例 ID。 |

## 示例

```bt
info = BT.info()

// 输出：1.1.0
print info.version
```

## 注意事项

- BT 是全局静态对象，不需要构造。
- BT 属性只读，不能覆盖 `BT` 本身，也不能写入 `BT.VERSION` 这类属性。
- 运行期信息按需读取；`BT.info()` 使用缓存快照。
- `BT.stats()` 只在调用时读取运行期资源状态，不会为普通表达式执行增加统计开销。