bun-runtime

name bun-runtime description Bun 作为运行时、包管理器、打包器和测试运行器。何时选择 Bun 而非 Node、迁移注意事项以及 Vercel 支持。 origin ECC 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 ，具有类似 Jest 的 API。 从 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 用于可重复的部署。 示例 运行和安装 # Install dependencies (creates/updates bun.lock or bun.lockb) bun install # Run a script or file 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 和生态系统发展迅速。