bun-runtime

Compatibility matrix

Platform support, with evidence labels

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Workflow

What the source asks the agent to do

1. 01

   何时使用

   优先选择 Bun 用于：新的 JS/TS 项目、安装/运行速度很重要的脚本、使用 Bun 运行时的 Vercel 部署，以及当您想要单一工具链（运行 + 安装 + 测试 + 构建）时。 优先选择 Node 用于：最大的生态系统兼容性、假定使用 Node 的遗留工具，或者当某个依赖项存在已知的 Bun 问题时。

   优先选择 Bun 用于：新的 JS/TS 项目、安装/运行速度很重要的脚本、使用 Bun 运行时的 Vercel 部署，以及当您想要单一工具链（运行 + 安装 + 测试 + 构建）时。优先选择 Node 用于：最大的生态系统兼容性、假定使用 Node 的遗留工具，或者当某个依赖项存在已知的 Bun 问题时。优先选择 Bun 用于：新的 JS/TS 项目、安装/运行速度很重要的脚本、使用 Bun 运行时的 Vercel 部署，以及当您想要单一工具链（运行 + 安装 + 测试 + 构建）时。 优先选择 Node 用于：最大的生态系统兼容性、假定使用 Node 的遗留工具，或者当某个依赖项存在已知的 Bun 问题时。
2. 02

   工作原理

   运行时：开箱即用的 Node 兼容运行时（基于 JavaScriptCore，用 Zig 实现）。 包管理器：bun install 比 npm/yarn 快得多。在当前 Bun 中，锁文件默认为 bun.lock（文本）；旧版本使用 bun.lockb（二进制）。 打包器：用于应用程序和库的内置打包器和转译器。 测试运行器：内置的 bun test，具有类似 Jest 的 API。

   运行时：开箱即用的 Node 兼容运行时（基于 JavaScriptCore，用 Zig 实现）。包管理器：bun install 比 npm/yarn 快得多。在当前 Bun 中，锁文件默认为 bun.lock（文本）；旧版本使用 bun.lockb（二进制）。打包器：用于应用程序和库的内置打包器和转译器。
3. 03

   示例

   Review the “示例” section in the pinned source before continuing.

   Review and apply the “示例” source section.
4. 04

   运行和安装

   Review the “运行和安装” section in the pinned source before continuing.

   Review and apply the “运行和安装” source section.

Permission review

Static risk signals and limitations

Pinned source

Provenance and original SKILL.md

Repository

affaan-m/ECC

Skill path

docs/zh-CN/skills/bun-runtime/SKILL.md

Commit

4e973d3eaf92d97f8d2e2d8abb39d8bdc8711b38

License

MIT

Collected

2026-07-28

Default branch

main

# 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);
});

const file = Bun.file("package.json");
const json = await file.json();

Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response("Hello");
  },
});