<< All versions
Skill v1.0.3
currentAutomated scan96/100loulanyue/awesome-claude-notes/bun-runtime
1 files
──Details
PublishedApril 28, 2026 at 07:20 AM
Content Hashsha256:982912f4c26127ec...
Git SHAa4b1fa4dc004
Bump Typepatch
──Files
Files (1 file, 2.9 KB)
SKILL.md2.9 KBactive
SKILL.md · 94 lines · 2.9 KB
version: "1.0.3" name: bun-runtime description: Bun 作为运行时、包管理器、打包器和测试运行器。何时选择 Bun 而非 Node、迁移注意事项以及 Vercel 支持。 source_path: skills/bun-runtime/SKILL.md 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 用于可重复的部署。
示例
运行和安装
bash
# Install dependencies (creates/updates bun.lock or bun.lockb)bun install# Run a script or filebun run devbun run src/index.tsbun src/index.ts
脚本和环境变量
bash
bun run --env-file=.env devFOO=bar bun run script.ts
测试
bash
bun testbun test --watch
typescript
// test/example.test.tsimport { expect, test } from "bun:test";test("add", () => {expect(1 + 2).toBe(3);});
运行时 API
typescript
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 和生态系统发展迅速。