技能使用指南

bun（Bun开发技能）Skill 是什么？如何下载安装使用？

Bun开发技能 Skill 帮你借助 AI 助手快速上手 Bun 一体化 JavaScript 运行时：内置包管理、TypeScript 原生执行、HTTP 与 WebSocket 服务、SQLite、密码哈希、打包器与测试框架。本文讲清技能安装步骤、核心用法、与 Node.js 等方案对比及典型场景，助你降低替代方案学习成本。立即了解，让开发流程更短更快。

Bun开发技能Skillbun
8 个章节 约 16 分钟阅读 AI 智能生成

Bun开发技能：用一体化 JavaScript 运行时把构建与测试流程压缩到一个工具里

  • 一个技能，覆盖整条工具链：Bun开发技能（英文名 bun，技能ID 13155）把包管理、TypeScript 直接运行、HTTP/WebSocket 服务、SQLite 数据库、密码哈希、打包器和测试框架打包进同一个运行时，减少在 npm、tsc、esbuild、jest 之间来回切换的成本。
  • 原生吃下 TypeScript：bun run index.ts 可以直接执行 .ts/.tsx 文件，不需要先编译成 JavaScript，也不需要额外配置 ts-node 或 tsx。
  • 速度是它的核心卖点：按技能详情给出的对比数据，启动时间约 7ms（Node.js 约 40ms），包安装约 1s（Node.js 约 10s），文件读取、HTTP 服务、SQLite 操作也都有明显提升。
  • 对 Node.js 生态友好：fs、path、http、Express 等大多数 Node.js API 与常见框架可直接运行，迁移成本低。
  • AI 技能负责“会用”，运行时负责“能跑”：安装该技能后，在 AI 助手中提到 Bun、bunx、Bun serve、Bun test 等触发词，就能获得贴近官方用法的命令与代码建议。

1. 该技能叫什么？如何下载安装 AI 技能提升开发效率？

基本信息

  • 技能中文名：Bun开发技能
  • 技能英文名：bun
  • 技能ID：13155
  • 触发词：Bun、Bun runtime、bun.sh、bunx、Bun serve、Bun test、JavaScript runtime

它解决什么问题

传统 Node.js 项目往往需要拼装一整套工具：用 npm/pnpm 装包、用 tsc 或 ts-node 处理 TypeScript、用 esbuild/Vite 打包、用 Jest 做测试、用 better-sqlite3 接数据库、用 dotenv 读环境变量。工具越多，配置越碎，新项目起步越慢。Bun开发技能对应的 Bun 运行时把这些能力内置化，而技能本身则负责让 AI 助手"知道怎么正确使用它"——你不需要翻文档，提问即可拿到可执行的命令与代码片段。

"一键安装"AI 技能的思路

  1. 确认前提：你需要一个支持 AI 技能（Skill）扩展的客户端或平台账号，并确认该平台已上架本技能；具体支持范围以官方说明为准。
  2. 找到技能：在技能市场/技能列表中以技能ID 13155 或名称"Bun开发技能 / bun"检索。
  3. 一键添加：点击安装/添加按钮完成载入，通常无需额外配置参数。
  4. 验证是否生效：新建对话，输入"用 Bun 创建一个 HTTP 服务器"或直接发送触发词bun test，若返回包含 Bun.serve、bun:test 等 Bun 原生 API 的针对性内容，说明技能已生效。

顺带把 Bun 运行时装上（技能详情提供的真实命令）

# macOS、Linux、WSL
curl -fsSL https://bun.sh/install | bash

# Windows（PowerShell）
powershell -c "irm bun.sh/install.ps1 | iex"

安装后在终端执行 bun --version 验证；再执行 bun init 创建新项目、bun install 安装依赖。技能负责"怎么用"，运行时负责"跑起来"，两者配合才完整。至于技能本身的安装入口、是否需要付费、是否需要特定版本客户端，请以官方说明为准。

2. 该技能的主要功能和特点

  • 包管理一体化：bun install、bun add、bun add -d、bun remove、bun update 覆盖日常依赖管理；bunx prisma generate 类似 npx 但速度更快；bun install --frozen-lockfile 适配 CI 模式；还能自动检测并读取 package-lock.json、yarn.lock，用 bun install --yarn 反向生成 yarn.lock 以保持兼容。
  • TypeScript / JSX 原生执行：bun run index.ts、bun run index.jsx 免构建直接跑，bun --watch run 提供监视模式，bun --hot run 提供热重载。
  • 内置高性能 API：Bun.file() 读取文件并支持 text()、json()、arrayBuffer()，可读取 size、type、lastModified；Bun.write() 支持写入文本、JSON，甚至直接把网络图片落盘；Bun.Glob 做通配符文件扫描。
  • 内置 HTTP + WebSocket 服务器：Bun.serve() 用一段 fetch 处理函数即可起服务，支持路由判断、Response.json、静态文件返回、请求体解析；server.upgrade() 支持 WebSocket 升级，并自带 open / message / close 生命周期与 ws.subscribe、ws.publish 发布订阅，还能挂 error 统一错误处理。
  • 内置数据库：bun:sqlite 提供建表、预编译语句、查询、事务（db.transaction）等能力，省掉原生模块编译。
  • 内置安全能力：Bun.password.hash / verify 支持 argon2id 与 bcrypt，可配置 memoryCost、timeCost；Bun.CryptoHasher 支持 sha256、md5、HMAC 等。
  • 内置打包器：命令行 bun build ./src/index.ts --outdir ./dist --minify --sourcemap --target browser --splitting，或 JS API Bun.build({...}) 配置 entrypoints、naming、external、define、loader，构建失败可通过 result.logs 排查。
  • 内置测试框架：bun:test 提供 describe / test / expect / beforeAll / afterAll / mock，支持 toContain、toMatchObject、toThrow、异步测试、mock.module 模块级模拟，以及 bun test --watch、--coverage。
  • Node.js 兼容：fs、path、http、Express 等可直接使用，迁移老项目时不必推倒重来。
  • 相对普通工具的优势：不是"再装一个工具"，而是"少装一堆工具"——dotenv 内置（.env 直接读 Bun.env）、SQLite 内置、测试框架内置、打包器内置，配置面显著变小。

3. 如何使用该技能？

第 1 步：在 AI 助手中调用技能并描述目标

直接用自然语言提问，例如：

“帮我用 Bun 初始化一个 TypeScript 项目，写一个带 JSON 接口和 WebSocket 广播的服务端。”

AI 助手命中 Bun 相关触发词后，会给出贴合 Bun 原生写法的方案。

第 2 步：创建并初始化项目

bun init          # 生成项目骨架
bun add express   # 需要一个依赖时
bun add -d typescript

第 3 步：写服务端代码（可直接运行的示例）

Bun.serve({
  port: 3000,
  async fetch(req, server) {
    const url = new URL(req.url);
    if (url.pathname === '/ws') {
      const ok = server.upgrade(req, { data: { userId: '123' } });
      if (ok) return undefined;
    }
    if (url.pathname === '/api/data' && req.method === 'POST') {
      const body = await req.json();
      return Response.json({ received: body });
    }
    return new Response('Not Found', { status: 404 });
  },
  websocket: {
    open(ws) { ws.subscribe('chat'); },
    message(ws, message) { ws.publish('chat', message); },
    close(ws) { console.log('客户端断开连接'); },
  },
});

第 4 步：运行与调试

bun run server.ts     # 直接跑 TS
bun --hot run server.ts  # 热重载

输入示例：向 /api/data POST {"name":"Alice"}； 输出说明：返回 {"received":{"name":"Alice"}}，同时 WebSocket 客户端会收到广播消息。

第 5 步：写测试并跑起来

import { describe, test, expect, mock } from 'bun:test';

describe('数学操作', () => {
  test('加法', () => { expect(1 + 1).toBe(2); });
});

bun test
bun test --coverage

第 6 步：打包发布

bun build ./src/index.ts --outdir ./dist --minify --sourcemap --target browser

进阶配置：在 bunfig.toml 中统一设置 [install] exact = true、[run] preload = ["./instrumentation.ts"]、[test] coverage = true 等默认行为。

4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
Bun开发技能（bun，本技能） AI 助手侧的 Bun 使用向导 + 对应运行时的一体化工具链 包管理、TS 原生执行、HTTP/WebSocket、SQLite、密码哈希、打包、测试 技能一键添加；运行时一条安装命令，终端 bun --version 验证 新项目起步、脚本工具、轻量 API 服务、全栈快速原型 优势：一个工具覆盖多环节，配置少、速度按详情数据明显领先；不足：部分 Node.js 边缘 API 与生态插件仍在补齐，团队需评估兼容性
Node.js + npm 最主流的 JavaScript 运行时与包管理器 运行时、包管理，其余能力依赖第三方工具 装机量最大，资料最全 企业级存量项目、依赖大量原生模块的场景 优势：生态最完整、稳定成熟；不足：TypeScript、打包、测试、数据库均需额外安装配置
Deno 现代化安全运行时 原生 TS、内置测试与格式化、权限模型 独立安装，学习新的权限与模块体系 安全敏感场景、绿色工具脚本 优势：默认权限隔离、标准库完整；不足：与 npm 生态虽是兼容但仍有迁移摩擦，团队接受度需要时间
pnpm + tsx + Vitest 组合 传统工具链的优化拼装 快速装包 + TS 直接执行 + 现代测试 需分别安装并维护三套配置 已有 Node.js 项目渐进升级 优势：改动小、可控性强、社区成熟；不足：仍是多工具组合，启动与安装速度不及一体化方案

选型建议：追求"少工具、快起步"，优先考虑 Bun开发技能 + Bun 运行时；存量大型项目且重度依赖特定原生模块，先用 Node.js；对权限隔离有硬性要求，评估 Deno。

5. 该技能的典型应用场景与实际体验情况

场景一：独立开发者做 API 原型

痛点：从零搭一个带数据库和 WebSocket 的后端，常常要装四五个依赖。使用方式：向 AI 助手说明"用 Bun 写一个带 SQLite 和 WebSocket 聊天的最小服务"，技能会给出 bun:sqlite 建表与 Bun.serve 广播的完整代码。实际体验：上手难度低，几乎是复制即跑；注意 SQLite 表结构变更仍需手工迁移。

场景二：前端团队写构建脚本 / 小工具

痛点：处理 JSON、读写文件、扫描目录这类脚本，用 Node.js 要额外引 dotenv、glob 等。使用方式：Bun.file() + Bun.Glob + Bun.env 三件套。实际体验：代码量明显变短；注意 Bun.Glob 需用 for await 消费。

场景三：老旧 Node.js 项目中做局部提速

痛点：全量迁移风险高，但安装依赖慢、测试慢。使用方式：先用 bun install 替换装包环节（可自动识别已有 lock 文件），再用 bun test 试跑测试。实际体验：改动面小、可回退；注意 Express 等主流框架可直接跑，但涉及特定原生扩展时需实测。

场景四：技术内容创作者与教学

痛点：写教程需要"能直接跑通"的示例。使用方式：让技能生成带注释的 Bun 示例代码，再本地 bun run 验证。实际体验：触发词明确，返回内容针对性强；注意示例中的端口、路径需按自己环境微调。

6. 该技能能为用户带来的价值

  • 效率提升可量化：按技能详情提供的对比数据，启动时间约 5.7 倍、包安装约 10 倍、文件读取约 10 倍、HTTP 服务约 4 倍、SQLite 约 3 倍；TypeScript 从"需要编译"变成"原生运行"，直接省去构建等待。
  • 门槛下降：dotenv、SQLite 驱动、测试框架、打包器全部内置，新项目不再需要研究一堆配置文件的正确写法，初学者也能快速跑出第一个可访问的服务。
  • 学习成本转移给 AI：AI 技能把官方文档里的关键用法压缩成可直接复制的命令与代码，遇到 bun.lockb、--frozen-lockfile、bunfig.toml 这类细节时不必翻页检索。
  • 长期价值：统一的工具链意味着更少的依赖升级冲突、更短的新人上手周期、更轻的 CI 环境镜像；对个人是"少配环境多写代码"，对团队是"降低协作摩擦"。

7. 常见问题 FAQ

Q1：这个技能怎么安装？需要先装 Bun 运行时吗？ 技能安装是在支持 AI 技能的客户端中按技能ID 13155 或名称检索后一键添加，具体入口与权限以官方说明为准；而 Bun 运行时是另一件事，需要在本地执行 curl -fsSL https://bun.sh/install | bash（Windows 用 PowerShell 脚本）安装。两者独立，建议都装：技能给方案，运行时跑代码。

Q2：收费吗？ Bun 运行时本身是开源项目，可通过官方渠道免费获取；AI 技能是否收费、是否包含在订阅内，取决于所在平台的计费规则，请以官方说明为准。

Q3：适合谁用？ 适合前端/全栈开发者、独立开发者、写自动化脚本的工程师，以及正在评估 Node.js 替代方案的技术负责人。如果你的项目重度依赖大量冷门原生模块，建议先做小范围兼容性验证。

Q4：和 Node.js 怎么选？会不会不兼容？ Bun 实现了大多数 Node.js API，fs、path、http、Express 等可直接使用，迁移通常是渐进的：先换装包（bun install），再换测试（bun test），最后考虑换运行时。存量超大项目可保留 Node.js，新项目或工具脚本优先 Bun。

Q5：Windows 上能用吗？ 可以，技能详情提供了 Windows PowerShell 安装命令。WSL 场景同样走 macOS/Linux 的安装脚本。安装完成后用 bun --version 确认，若命令未识别，检查 PATH 是否已加载，具体排查方式以官方说明为准。