Bun DocsBun 实用文档
面向新手与 AI Agent 的双语、任务型 Bun 知识库
最后更新于
Bun 是一套 JavaScript / TypeScript 工具链：一个可执行文件同时提供运行时、包管理器、测试运行器和打包器。这份文档不替代 Bun 官方 API 参考，而是提供更短的学习路径、明确的选择边界和可直接交给 Agent 的上下文。
选择你的阅读方式
我是第一次使用 Bun
安装、心智模型和一个完整小项目。
我要迁移 Node.js 项目
先并行采用，再验证兼容性与部署环境。
我是 AI Agent
先读任务入口，再只加载当前任务需要的页面。
我要部署到云端
区分容器、Serverless 与边缘平台上的真实运行时。
我要构建 AI 应用
流式输出、工具安全、RAG、观测与评测。
我要连接数据库和存储
Bun.SQL、Redis、S3、Drizzle 与生产连接边界。
我要建立生产基线
TypeScript、CI、供应链、环境变量与发布门禁。
我只想查命令
命令、配置文件和退出条件速查。
能力与任务地图
| 目标 | 首选命令 | 对应页面 |
|---|---|---|
直接运行 .js、.ts、.tsx | bun run <file> | 运行时 |
| 安装和管理 npm 包 | bun install / bun add | 包管理器 |
| 执行 Jest 风格测试 | bun test | 测试运行器 |
| 生成浏览器或服务端产物 | bun build | 打包器 |
| 组织多应用和共享包 | bun --filter | Monorepo 与 Workspaces |
| 使用 SQL、Redis 或 S3 | Bun.SQL / RedisClient / S3Client | 数据库与存储 |
| 建立可复现生产门禁 | bun ci | 生产工程基线 |
| 选择框架、ORM 和工程工具 | 先列约束 | 生态选型决策 |
版本表达
本文档用 1.x 表示当前稳定大版本，不把易过期的小版本号写进示例。需要精确行为时，先运行 bun --version，再核对官方对应版本说明。
文档如何照顾两类读者
- 新人路径：先解释目的和心智模型，再给命令、预期结果、常见错误。
- AI 路径：页面保持稳定标题、显式前置条件、决策表和“不要猜”的边界。
- 每页可在 URL 后追加
.md获取纯 Markdown；全站另有/llms.txt与/llms-full.txt。
最短起点
如果你尚未安装 Bun，继续阅读 5 分钟上手。