Bun DocsCLI 与配置速查
Bun 常用命令、配置文件、环境变量和排错顺序
最后更新于
命令映射
| 目标 | 命令 |
|---|---|
| 查看版本 / revision | bun --version / bun --revision |
| 运行文件 | bun run index.ts |
| 运行 package script | bun run dev |
| 自动重启 | bun --watch index.ts |
| 初始化项目 | bun init |
| 安装依赖 | bun install |
| 冻结安装 | bun install --frozen-lockfile |
| 添加 / 删除依赖 | bun add <pkg> / bun remove <pkg> |
| 执行包 CLI | bunx <pkg> |
| 测试 | bun test |
| 打包 | bun build <entry> |
配置优先级
| 文件 | 职责 | 是否必需 |
|---|---|---|
package.json | 脚本、依赖、workspaces、模块元数据 | 是 |
bun.lock | 精确依赖图 | 安装依赖的项目应提交 |
bunfig.toml | Bun 特有安装、运行与测试设置 | 否 |
tsconfig.json | TypeScript 解析、路径别名和类型检查 | TS 项目通常需要 |
.env* | 本地环境变量 | 可选；密钥文件不要提交 |
最小 bunfig.toml
[run]
silent = false
[test]
coverage = false
[install.lockfile]
save = true只添加已从当前官方文档核对过、且项目确实需要的键。
排错顺序
bun --version与bun --revision。- 确认工作目录和实际命中的
package.json。 - 检查
bun.lock、bunfig.toml和环境变量。 - 用最小复现隔离框架、依赖或 Bun 运行时问题。
- 查询当前版本官方文档与 issue，再决定升级或绕过。
Agent 输出格式
Environment: Bun <version>, <os>/<arch>
Command: <exact command>
Expected: <observable result>
Actual: <exit code + concise error>
Minimal reproduction: <path or snippet>
Verification: <tests actually run>官方参考：Bun Runtime CLI、bunfig.toml。