Bun DocsBun 版本特性矩阵
常用能力首次出现的 Bun 版本，用于升级决策与 Agent 任务路由
最后更新于
什么时候查这页
- 文档示例用了某个 flag 或 API，先确认你的
bun --version达到最低版本。 - 给 Agent 下任务前，把最低版本写进约束，避免它为你的版本生成不存在的用法。
- 升级前按版本号阅读官方发布说明，不只看本表。
矩阵
| 能力 | 首次可用版本 | 相关页面 |
|---|---|---|
Bun.serve 的 routes 声明式路由 | 1.2.0 | 运行时 |
Bun.sql（PostgreSQL 客户端） | 1.2.0 | 数据库与存储 |
文本锁文件 bun.lock 成为默认格式 | 1.2.0 | 包管理器 |
依赖安装脚本默认阻止 + bun pm trust / bun pm untrusted | 1.2.0 | 包管理器 |
isolated linker（linker = "isolated"，且成为 Workspace 默认） | 1.3.0 | Monorepo 与 Workspaces |
Workspaces Catalog（catalog: 协议） | 1.2.14 | Monorepo 与 Workspaces |
bun audit | 1.2.15 | 包管理器 |
bun audit --prod / --audit-level / --ignore | 1.2.21 | 生产工程基线 |
| Bun.SQL 统一入口支持 MySQL / MariaDB、SQLite | 1.2.x（2025 年中） | 数据库与存储 |
RedisClient（内置 Redis 客户端） | 1.2.x（2025 年） | 数据库与存储 |
RedisClient Pub/Sub | 1.2.23 | 数据库与存储 |
minimumReleaseAge（最短发布时间） | 1.3.0 | 包管理器 |
AGENT=1 / CLAUDECODE=1 精简测试输出 | 1.2.x | 测试运行器 |
bun test --isolate / --parallel | 1.3.13 | 测试运行器 |
精确小版本以一手资料为准
标注 1.2.x 的行表示该能力在 1.2 周期内引入，但本页核验时未锁定到具体小版本。写进 CI 约束或迁移计划前，查 Bun 官方博客与 Release 页面确认。发现本表与一手资料冲突时，以一手资料为准并反馈给站点维护者。
使用约定
- 版本号均指稳定版；canary 构建的行为不计入本表。
- “首次可用”不等于“生产就绪”：新能力仍按 生产工程基线 做目标环境验证。
- 表中只收录影响任务路由或迁移决策的能力，不复制完整 changelog。
Agent 用法
在任务约束里写两行即可消除一整类幻觉：
Environment: Bun 1.3.14 (pinned). Do not use features newer than this version.
If a capability requires a newer Bun, stop and report instead of guessing.