Bun Runtime Skill 是 Everything Claude Code 体系下，专为现代 JavaScript/TypeScript 项目提供的全能运行时支持。它集成了 Bun 作为运行时、包管理器、构建工具和测试框架，适用于新项目、追求极致性能的脚本、以及 Vercel 等平台部署。本文将系统讲解如何在 AI 编程助手环境下选择 Bun 而非 Node、迁移注意事项、Vercel 配置方法，以及与其他 Skill/Agent 的协作场景，帮助你在实际项目中用好这一 Skill。

Everything Claude Code Bun Runtime Skill：何时选 Bun 而非 Node、迁移注意事项与 Vercel 支持

Bun Runtime Skill 是 Everything Claude Code 插件体系中，专为 JS/TS 生态设计的生产级运行时能力扩展。它让 Claude Code、Codex、Cursor 等 AI 编程助手能够智能识别、推荐并自动化切换到 Bun 作为项目的运行环境、包管理、构建与测试工具。相比传统 Node.js，Bun 具备更快的安装与启动速度、原生 TypeScript 支持、一体化工具链等优势，尤其适合对开发效率和部署速度有高要求的场景。

1. 适用场景与触发条件

何时优先选用 Bun 而非 Node

• 新建 JS/TS 项目：希望从一开始就用更快的工具链，减少依赖配置。
• 脚本/CLI 工具开发：对安装和运行速度敏感，Bun 的冷启动和包安装极快。
• Vercel 等云平台部署：Vercel 已原生支持 Bun 运行时，可直接在设置中切换。
• 一体化工具链需求：希望用同一工具完成依赖安装、构建、测试，无需额外配置。
• AI 自动化脚本生成与调试：Claude Code 等 Agent 能自动识别 Bun 项目结构，智能生成兼容脚本。

何时仍应选择 Node

• 最大化生态兼容性：部分依赖或工具链仅支持 Node，或对 Bun 存在兼容性问题。
• 遗留项目/复杂多包仓库：迁移成本高，或已有大量 Node-specific 工具链集成。

Skill 触发时机

• 检测到项目根目录存在 bun.lock/bun.lockb、bunfig.toml 或 package.json 且无 node_modules 时，AI 会建议或自动切换 Bun。
• 迁移脚本、构建流程、CI/CD 配置时，Agent 会优先推荐 Bun 相关命令。
• 在 Vercel 部署配置、依赖安装、测试脚本生成等环节，自动应用 Bun 语法和最佳实践。

想了解更多 AI 编程助手的 Skill 体系与自动化触发机制，可参考 Everything Claude Code 快速上手指南。

2. 实际操作流程（Step by Step）

Step 1：初始化或迁移到 Bun

• 新项目：

  bun init
  # 或手动创建 package.json 后
  bun install

• 从 Node 项目迁移：
  1. 确认 Node 依赖无 Bun 兼容性问题（可用 Agent 自动检测）。
  2. 用 Bun 安装依赖并生成锁文件：

     bun install

  3. 替换启动/构建/测试命令为 Bun 版本（见下方示例）。

Step 2：运行与调试脚本

• 运行开发脚本或入口文件：

  bun run dev
  bun run src/index.ts
  # 也可直接执行
  bun src/index.ts

• 支持原生 TypeScript，无需额外转译。

Step 3：环境变量与脚本参数

• 指定环境变量文件或临时变量：

  bun run --env-file=.env dev
  FOO=bar bun run script.ts

Step 4：测试用例编写与执行

• Bun 内置 Jest 风格测试框架，直接编写 .test.ts 文件：

  // test/example.test.ts
  import { expect, test } from "bun:test";
  
  test("add", () => {
    expect(1 + 2).toBe(3);
  });

• 执行测试：

  bun test
  bun test --watch

Step 5：Bun 原生 API 使用

• 读取文件、启动服务等操作更高效：

  const file = Bun.file("package.json");
  const json = await file.json();
  
  Bun.serve({
    port: 3000,
    fetch(req) {
      return new Response("Hello");
    },
  });

Step 6：Vercel 平台部署配置

• 在 Vercel 项目设置中，将 Runtime 设为 Bun。
• 构建命令：

  bun run build
  # 或
  bun build ./src/index.ts --outdir=dist

• 安装依赖（推荐锁定版本以保证可复现）：

  bun install --frozen-lockfile

3. 典型输出示例

• 依赖安装日志：

  bun install v1.0.0
  12 packages installed in 180ms

• 测试输出：

  PASS  test/example.test.ts
    ✓ add (3ms)

• Vercel 构建日志：

  Running "bun run build"
  Build completed in 1.2s

4. 与其他 Agent/Skill 的协作关系

• 常见配套 Agent：
  • Build Error Resolver Agent：自动识别 Bun 构建/依赖错误并修复。
  • Performance Optimizer Agent：结合 Bun 的高性能运行特性，优化启动与打包流程。
  • Agent Harness Construction Skill：自动生成兼容 Bun 的 Agent action space 和 tool definitions。
• 与其他 Skill 协作：
  • 可与 Backend Patterns Skill、Deployment Patterns Skill 联动，自动生成 Bun 兼容的后端架构与部署流水线。
  • 在 Verification Loop Skill 中，自动用 Bun 运行测试与验证循环。

5. 最佳实践与注意事项

• 锁文件管理：务必提交 bun.lock 或 bun.lockb，确保依赖可复现。
• TypeScript 支持：Bun 原生支持 .ts，无需额外配置。
• 依赖更新：Bun 及其生态更新快，建议定期升级依赖和 Bun 版本。
• 兼容性评估：部分 npm 包可能暂不支持 Bun，遇到问题可回退 Node 或关注 Bun issue tracker。

想深入了解 AI 编程助手如何自动化构建、测试与部署全流程，推荐阅读 Everything Claude Code 完全指南。

---

FAQ

Q: Bun 和 Node 在 AI 编程助手项目中如何选择？
A: 新项目、追求速度和一体化工具链时优先选 Bun；如需最大 npm 兼容性或已有大量 Node-only 工具则选 Node。

Q: 迁移到 Bun 时需要注意哪些坑？
A: 检查依赖兼容性、替换脚本命令、提交新锁文件，并在 CI/CD 流程中用 Bun 替换 npm/yarn。

Q: Vercel 上用 Bun 部署有哪些特别配置？
A: 在 Vercel 项目设置中选择 Bun 运行时，构建/安装命令用 bun run build 和 bun install --frozen-lockfile，确保锁文件已提交。

---