bun-expert

Bun Runtime 开发指南

此技能有意以 Bun 官方文档为依据。Bun 发展迅速，因此请优先参考最新文档，不要依赖固定的发布时间表或基准测试声明。

---

最新功能速览

Bun 不断推出新的内置功能。以下列表涵盖了大约从 Bun 1.3（2025 年 10 月）到 Bun 1.3.14（2026 年 5 月）期间推出的功能——模型的训练数据很可能早于这些功能。对于更新的内容，请先查看 https://bun.com/blog，再判断某项功能是否不存在。

优先使用以下功能，而不是安装其他依赖：

• Bun.SQL：一个客户端支持 Postgres、MySQL/MariaDB 和 SQLite——无需安装 pg、mysql2 或 postgres。
• Bun.redis：原生 Redis/Valkey 客户端——无需安装 ioredis/node-redis。
• Bun.secrets：由操作系统密钥链支持的凭据存储——无需安装 keytar。
• Bun.YAML.parse/.stringify：内置 YAML 支持——无需安装 js-yaml/yaml。
• CompressionStream/DecompressionStream 现在支持 "brotli" 和 "zstd" 格式，不再局限于 gzip/deflate。
• Bun.stripANSI、URLPattern 和 DisposableStack/AsyncDisposableStack 均为内置功能——无需安装 strip-ansi，也无需使用用户空间的 URL 模式或清理辅助工具。
• Bun.markdown（.html/.render/.react）：内置 CommonMark+GFM 解析器；bun ./file.md 可在终端中渲染 Markdown——常见场景下无需使用 markdown-it/marked。
• bun:test 已加入假计时器（useFakeTimers、advanceTimersByTime、setSystemTime、useRealTimers）——无需安装 sinon/@sinonjs/fake-timers。
• HTML 入口开发服务通过 import.meta.hot 支持热模块替换——简单的前端项目无需单独使用 Vite/webpack 开发服务。
• bun install --linker=isolated 配合 globalStore = true（或 BUN_INSTALL_GLOBAL_STORE=1）：仍处于实验阶段的全局虚拟存储，可显著加快缓存命中时的安装速度。
• 以下功能仍处于实验阶段，不要默认在生产环境中使用：Bun.WebView（无需 Puppeteer/Playwright 的浏览器自动化）以及通过 Bun.serve({ http3: true }) 和 fetch({ protocol: "h3" }) 实现的 HTTP/3 over QUIC。

---

内置 API 一览

需求	Bun API
HTTP 服务 + WebSocket	Bun.serve()
SQL 数据库	sql、SQL、Bun.sql、Bun.SQL
兼容 S3 的存储	s3、S3Client
Redis	redis、RedisClient
定时任务（cron）	Bun.cron、Bun.cron.parse
图像处理	Bun.Image、Blob#image()、Bun.file().image()
浏览器自动化	Bun.WebView
Markdown 渲染	Bun.markdown.html、Bun.markdown.render、Bun.markdown.react
Shell 脚本	Bun.$ / $
本地文件	Bun.file、Bun.write
SQLite（嵌入式）	bun:sqlite
密码哈希	Bun.password
由 PTY 支持的子进程	Bun.Terminal、Bun.spawn({ terminal })

---

深入参考

参考资料	内容
references/builtin-apis.md	Bun.serve、HTTP/3、WebSocket、SQL、S3、Redis、Bun.Image、Bun.WebView、Markdown、cron、shell、PTY、文件系统和加密 API
references/package-management.md	安装、锁文件、隔离链接器、全局虚拟存储、目录和生命周期脚本安全
references/testing-and-bundling.md	bun test 用法、测试套件拆分标志、模拟模式、bun build CLI 和 API
references/node-migration.md	实用的 Node 到 Bun 迁移步骤和兼容性指南

---

权威文档

• https://bun.com/docs
• https://bun.com/blog