# 如何使用

## 功能

BT 解释器执行 `.bt` 文件。不带命令或源码参数启动时，如果当前目录存在 `main.bt`，会默认执行该文件；否则进入命令行交互模式。普通启动不会安装 BT，也不检查安装版本。

## 运行调试

```bt

// 输出：hello world
print 'hello world'
```

安装编辑器扩展 `bt-lang` 后，可以在项目目录中创建 `main.bt` 并直接运行。

## 命令行执行

```text
bt demo.bt
bt -c demo.bt
```

两个命令都执行脚本并正常退出，不会额外暂停。如果 BT 不在 `PATH` 中，使用解释器完整路径。在 `bt>` 交互提示符中执行脚本时，输入 `-c demo.bt`。

## 安装命令

待下一版本发布：执行 `bt install`，把当前解释器安装到当前用户目录。交互提示符也接受 `install` 和 `update`。使用 `bt update` 从官网更新已有解释器安装，使用 `bt update sqlite` 更新已安装的 SQLite 扩展。`bt install sqlite` 仍用于安装 SQLite 扩展。首次安装命令、固定路径、版本选择和平台要求见[环境搭建](/zh-hans/docs/build)。

## 双击脚本

待下一版本发布：完成安装并将 BT 选为 `.bt` 默认应用后，双击 `demo.bt` 会打开终端，使用固定安装路径中的解释器执行。启动器在成功、报错或调用 `exit()` 后等待按 Enter，让输出保持可见。它执行原始脚本，不插入 `pause()`，也不改变脚本的返回行为。这种等待仅用于文件关联启动；终端或其他应用中的普通脚本调用不使用它。

## Windows

可以把 `bt.exe` 放在项目目录中。不带参数打开解释器时，仍会优先执行当前目录下的 `main.bt`；不存在时进入交互提示符。双击解释器本身不会触发安装，也不会触发脚本关联的退出等待。

## Linux 和 macOS

```shell
cd /home/project
chmod +x bt
./bt
```

## 注意事项

- 脚本文件统一使用 `.bt` 后缀。
- Web 服务、桌面应用和普通 CLI 脚本都复用同一套 BT 语言语法。