Bun 是一套用于开发和运行 JavaScript 与 TypeScript 应用程序的开源软件工具集。它将运行时、包管理器、打包器和测试运行器集成在一个可执行文件中。Bun 的设计注重与 Node.js 及其软件包生态系统的广泛兼容,既可以作为一体化开发工具链,也可以替换现有项目中的个别工具。它的运行时使用与 WebKit 相关的 JavaScript 引擎 JavaScriptCore,而不是 Node.js 使用的 V8 引擎。
设计与架构
Bun 旨在降低执行开销,同时简化 JavaScript 开发环境的搭建。安装依赖、执行脚本、转换 TypeScript、打包应用程序代码和运行测试等通常由不同程序处理的任务,都可以通过同一个命令行界面完成。
Bun 的大部分代码使用 Zig 编程语言实现,应用程序代码则由其 JavaScript 引擎 JavaScriptCore 执行。两者的职责有所不同:JavaScriptCore 提供语言执行和内存管理功能,包括垃圾回收;Bun 则提供文件访问、网络通信、模块加载和包管理等功能。
与其他服务端 JavaScript 运行时一样,Bun 支持异步编程和事件循环。JavaScript 的 Promise 和异步输入输出机制使程序能够处理大量尚未完成的操作,而不必为每个连接分配独立的应用程序线程。这并不意味着运行时中的所有工作都在单个线程上完成,也不意味着异步代码会自动并行执行 CPU 密集型任务。
Bun 可在 Linux、macOS 和 Windows 上运行,具体支持的平台和处理器取决于所用版本的要求。
运行时与语言支持
JavaScript 和 TypeScript 执行
Bun 能够执行 JavaScript,也可以直接接受 TypeScript 源文件。此外,它还支持 JSX 及其 TypeScript 对应形式 TSX;JSX 是一种常用于描述用户界面的语法扩展。
直接执行 TypeScript 并不意味着会进行完整的静态类型检查。Bun 会将 TypeScript 转换为可执行的 JavaScript,移除类型注解,并处理受支持的语法。检查程序是否符合 TypeScript 的类型系统仍是一项独立任务,通常由 TypeScript 编译器或开发工具完成。
例如:
const message: string = "Hello from Bun";
console.log(message);
可以使用以下命令执行:
bun run hello.ts
同一组命令也可以运行项目 package.json 文件中声明的脚本。
模块与兼容性
Bun 同时支持使用 import 和 export 的 ECMAScript 模块,以及传统上使用 require 和 module.exports 的 CommonJS 模块。这两种模块系统之间的互操作性十分重要,因为 JavaScript 项目经常依赖采用不同规范编写的软件包。
Bun 实现了许多 Node.js 应用程序编程接口,包括文件、路径、流、缓冲区和网络相关接口。它还实现了 fetch、Request 和 Response 等 Web 标准接口,使服务端运行时与网页浏览器能够采用一些相似的编程方式。
兼容 Node.js 是一项工程目标,并不代表保证两者行为完全一致。应用程序可能依赖未公开的实现细节、特定的原生扩展,或调度和错误处理方面的细微差异。因此,兼容程度取决于具体应用程序使用的接口和软件包。
Bun 专有接口
除兼容性接口外,Bun 也提供自己的接口,包括用于处理超文本传输协议请求的 Bun.serve、通过 Bun.file 和 Bun.write 进行的文件操作,以及通过 bun:sqlite 模块对 SQLite 的访问。
以下最简服务器示例展示了其请求与响应模型:
Bun.serve({
port: 3000,
fetch(request) {
return new Response("Hello");
},
});
Bun 专有接口可以提供更简洁的调用方式或性能优势,但直接使用这些接口会使程序依赖 Bun,除非其他环境也提供兼容实现。
包管理
Bun 的包管理器可以安装 package.json 中描述的依赖,并从 npm 注册表获取软件包。常见命令包括:
bun install
bun add package-name
bun remove package-name
项目不必使用 Bun 作为运行时,也能使用它的包管理器。例如,可以用 Bun 安装依赖,同时继续在 Node.js 上运行应用程序。
依赖解析会选出满足已声明约束的软件包版本。锁文件会记录解析得到的依赖关系图,使后续安装能够更一致地复现这些版本选择。Bun 曾使用二进制锁文件 bun.lockb,后来又引入了基于文本的新格式 bun.lock;具体行为取决于 Bun 版本和项目配置。
软件包安装也涉及安全问题。依赖中可能包含在安装过程中执行代码的生命周期脚本。Bun 提供可信依赖机制,用于控制哪些依赖可以运行此类脚本。这减少了一种安装期间执行代码的途径,但并不能证明某个软件包是安全的:当应用程序导入或运行软件包时,其中的代码仍可能执行。
打包与测试
打包器
模块打包器会沿着项目中的导入关系查找模块,并将其合并或重新组织为适合部署的输出文件。Bun 通过 bun build 和可由程序调用的构建接口提供这项功能。
它的构建系统能够转换 JavaScript、TypeScript 和 JSX,生成源码映射,并进行代码压缩和摇树优化等处理。摇树优化会移除被判定为未使用的代码,但实际结果取决于模块结构、副作用和构建配置。
打包与运行时执行是不同的过程。Bun 可以生成面向浏览器或其他 JavaScript 环境的代码,但构建成功本身并不能证明目标环境中具备所有必需的接口。
测试运行器
bun test 命令通过内置的测试用例、断言、生命周期钩子和模拟功能来运行测试。其接口遵循 JavaScript 开发者熟悉的 Jest 风格测试惯例。
这种集成可以减少配置和代码转换开销,对 TypeScript 项目尤其如此。不过,语法相似并不意味着与 Jest 的每项功能、插件或执行行为都完全兼容。依赖专门测试基础设施的项目可能需要进行调整。
开发历史
Bun 由 Jarred Sumner 创建,在 2023 年 9 月发布 1.0 版本之前就已公开开发。它最初着重强调快速的 JavaScript 执行和依赖安装,随后逐步扩展为一体化工具链。
核心项目以 MIT 许可证分发,随附的第三方组件则分别受各自许可证约束。源代码公开使开发者能够检查实现、报告兼容性问题并贡献修改。
性能与实际局限
性能是 Bun 的核心设计目标,但“更快”并不是单一指标。启动延迟、软件包安装时间、测试执行、HTTP 吞吐量、构建速度和内存占用,衡量的是工具链的不同方面。
结果取决于工作负载、硬件、操作系统、缓存状态、依赖关系图和软件版本。小型 HTTP 基准测试或许能反映运行时开销,但对于主要耗时在外部数据库查询或网络延迟上的应用程序,其参考价值可能很有限。JavaScriptCore 和 V8 在不同计算负载下的表现也可能不同。
Bun 的一体化设计能够简化开发,但也将多项职责集中在一个工具中。更新 Bun 可能同时改变运行时行为、依赖安装、构建和测试。另一方面,其组件也可以单独采用,让项目在重视兼容性或既有工作流程的环节保留其他工具。
可移植性的主要分界在于标准化的 JavaScript 行为与特定环境提供的功能之间。语言语法可能具有可移植性,但 Node.js 内部机制、Bun 专有接口、原生扩展以及对操作系统的假设则未必如此。因此,支持某种编程语言,并不等于与应用程序的执行环境完全兼容。