用途:该技能面向 Bun 项目的编写与代码审查,核心主张是运行时、工具链与内置能力合并为单一二进制,优先使用 Bun 自带能力而非重复引入依赖,只有在 Bun 无原生等价物或代码需同时运行于 Node 时才使用 node: 模块。
主要能力与用法:
- 服务器:用 Bun.serve() 声明 routes,fetch 仅处理未匹配请求;必须配置错误处理器或显式 development: false,否则出错时会向客户端返回上下文错误页;idleTimeout 默认 10 秒,慢处理需调高或调用 server.timeout(req, 0);WebSocket 处理器在 websocket 对象中每服务器声明一次。
- 文件与进程:Bun.file() 惰性、不触盘;Bun.write() 支持多种数据类型并按组合选择最快系统调用;Bun.$ 为进程内解释器,模板插值为字面量字符串,非零退出抛 ShellError,可用 .nothrow();Bun.spawn 的 stderr 默认 inherit,需传 stderr: "pipe" 才能读取。
- 测试:从 bun:test 导入;mock.module() 不提升;expectTypeOf 运行时为空操作,类型需另跑 bunx tsc --noEmit;并发有三个独立开关(--parallel、--concurrent、--shard),默认单测超时 5000 毫秒。
- 包管理:trustedDependencies 替换而非扩展内置允许列表;CI 应运行 bun ci 而非 bun install;链接器默认由锁文件 configVersion 决定。
- 构建:Bun.build() 失败时抛 AggregateError,默认 throw 为 true;生产二进制用 --compile --minify --sourcemap --bytecode;编译产物不自动加载 tsconfig.json 与 package.json,但会加载 .env 和 bunfig.toml。
- 数据客户端:bun:sqlite 建议 strict: true,配合 WAL;Bun.sql 中每个模板插值均为参数,查询为惰性。
限制与版本:Bun 只有一条稳定线、无长期支持分支,建议在 CI 中固定版本;资料给出 1.3.0 至 1.4.0 各特性版本下限,规则默认针对 1.3.0 及以上。Bun.$ 不是 /bin/sh,内置命令集固定。Bun.markdown.html() 不做净化,不可信 Markdown 需先净化。官方文档未提供的功能、收费与平台细节暂未提供。