用途:在工作涉及 Bun 运行时环境时使用,覆盖文件系统操作、HTTP 服务器、环境变量以及 Bun 专有 API。
主要能力:Bun 提供多个为性能优化的全局 API,包括 Bun.file()(快速读取文件并自动识别内容类型)、Bun.write()(高性能写入)、Bun.serve()(HTTP 服务器)、Bun.env(类型安全的环境变量)和 Bun.$(用模板字面量执行 Shell 命令)。文件 API 支持 text()、json()、arrayBuffer() 与 stream() 等读取方式,写入可直接传入字符串或对象。Bun.serve() 支持基于 fetch 的路由响应,并内置 WebSocket 支持,可通过 server.upgrade(req) 升级连接并定义 message、open、close 回调。此外提供 Bun.password.hash() 与 Bun.password.verify() 做密码哈希与校验。
使用方式:读取文件如 const file = Bun.file("./data.json"); await file.json();写入如 await Bun.write("output.txt", "Hello, Bun!");启动服务用 Bun.serve({ port: 3000, fetch(req) {...} });Shell 命令用 import { $ } from "bun"; await $ls -la.text()。环境变量优先使用 Bun.env,process.env 也可用。资料给出 API 服务器、文件上传处理、读取 JSON 与 TOML 配置等常见模式示例。
最佳实践与限制:优先使用 Bun 原生 API 而非 Node.js 等价实现,避免不必要地混用两套 API;不要忽略错误处理,可结合 file.exists() 与 try/catch;避免同步读取阻塞事件循环,改用异步操作。资料中未提供安装命令、平台支持范围、性能基准数据与收费信息。相关技能包括 bun-testing、bun-bundler 和 bun-package-manager。