Bun 运行时 是做什么的?
Bun 是一个快速的全能 JavaScript 运行和工具集:运行时、包管理器、打包器和测试运行器。
何时使用
- 优先选择 Bun 的场景:新的 JS/TS 项目、对安装/运行速度有要求的脚本、使用 Bun 运行时的 Vercel 部署,以及希望使用单一工具链(运行 + 安装 + 测试 + 构建)时。
- 优先选择 Node 的场景:需要最大生态兼容性、依赖 Node 的传统工具链,或当某个依赖存在已知的 Bun 兼容性问题时。
在以下情况下使用:采用 Bun、从 Node 迁移、编写或调试 Bun 脚本/测试,或在 Vercel 及其他平台上配置 Bun。
工作原理
- 运行时:可替代 Node 的兼容运行时(基于 JavaScriptCore,用 Zig 实现)。
- 包管理器:
bun install速度显著快于 npm/yarn。当前版本 Bun 默认生成文本格式的bun.lock锁文件;旧版本使用二进制格式的bun.lockb。 - 打包器:内置打包器和转译器,适用于应用和库。
- 测试运行器:内置
bun test,API 与 Jest 类似。
从 Node 迁移:将 node script.js 替换为 bun run script.js 或 bun script.js。使用 bun install 代替 npm install;大多数包都能正常工作。通过 bun run 运行 npm 脚本;使用 bun x 实现类似 npx 的一次性运行。Node 内建模块受支持;优先使用 Bun 的 API 以获得更好的性能。
Vercel:在项目设置中将运行时设为 Bun。构建命令:bun run build 或 bun build ./src/index.ts --outdir=dist。安装命令:bun install --frozen-lockfile 以确保可重现部署。
示例
运行和安装
# 安装依赖(创建或更新 bun.lock 或 bun.lockb)
bun install
# 运行脚本或文件
bun run dev
bun run src/index.ts
bun src/index.ts
脚本和环境变量
bun run --env-file=.env dev
FOO=bar bun run script.ts
测试
bun test
bun test --watch
// test/example.test.ts
import { expect, test } from "bun:test";
test("add", () => {
expect(1 + 2).toBe(3);
});
运行时 API
const file = Bun.file("package.json");
const json = await file.json();
Bun.serve({
port: 3000,
fetch(req) {
return new Response("Hello");
},
});
最佳实践
- 提交锁文件(
bun.lock或bun.lockb)以确保可重现安装。 - 优先使用
bun run执行脚本。对于 TypeScript,Bun 原生支持运行.ts文件。 - 保持依赖项更新;Bun 及其生态系统发展迅速。