# BT.add_path

## 功能

向当前有效 PATH 追加或前置路径。

## 语法

```bt
BT.add_path(path)
BT.add_path(path, 'prepend')
```

## 参数

| 参数 | 类型 | 必填 | 默认值 | 说明 |
| ------ | ------ | ------ | ------ | ------ |
| path | String | 是 | 无 | 要写入 PATH 的路径。 |
| mode | String | 否 | append | 写入位置；`prepend` 表示前置，省略或 `append` 表示追加。 |

## 返回值

| 类型 | 说明 |
| ------ | ------ |
| Bool | 实际写入返回 true；路径已存在且没有重复添加时返回 false。 |

## 示例

```bt
BT.add_path('@/bin')
result = BT.has_path('@/bin')

// 输出：true
print result
```

## 注意事项

- 路径会先按 BT 路径规则解析，`@` 和 `@/...` 基于项目根。
- 该方法只写入 BT 运行期环境变量 overlay，不修改系统永久 PATH。