打包工具

// 为生产环境构建
await Bun.build({
  entrypoints: ['./src/index.ts'],
  outdir: './dist',
  target: 'node',        // 'browser' | 'bun'
  minify: true,
  sourcemap: 'external',
  splitting: true,       // 代码分割
  format: 'esm',         // 'cjs' | 'esm'
});

// 命令行界面
bun build ./src/index.ts --outdir ./dist --minify

构建配置

// bunfig.toml 的替代方案 - build.ts
const result = await Bun.build({
  entrypoints: ['./src/index.tsx'],
  outdir: './dist',
  target: 'browser',
  minify: {
    whitespace: true,
    identifiers: true,
    syntax: true,
  },
  define: {
    'process.env.NODE_ENV': '"production"',
  },
  external: ['react', 'react-dom'],
  loader: {
    '.png': 'file',
    '.svg': 'text',
  },
});

if (!result.success) {
  console.error('构建失败:', result.logs);
  process.exit(1);
}

测试运行器

// math.test.ts
import { describe, it, expect, beforeAll, mock } from 'bun:test';

describe('math', () => {
  it('adds numbers', () => {
    expect(1 + 2).toBe(3);
  });

  it('handles async', async () => {
    const result = await fetchData();
    expect(result).toBeDefined();
  });
});

// 模拟
const mockFn = mock(() => 42);
mockFn();
expect(mockFn).toHaveBeenCalled();

// 模块模拟
mock.module('./config', () => ({
  apiUrl: 'http://test.local',
}));



# 运行测试
bun test

# 监视模式
bun test --watch

# 覆盖率
bun test --coverage

# 过滤
bun test --filter "user"

HTTP 服务器

// 原生 Bun 服务器（最快）
Bun.serve({
  port: 3000,
  fetch(req) {
    const url = new URL(req.url);

    if (url.pathname === '/api/health') {
      return Response.json({ status: 'ok' });
    }

    if (url.pathname === '/api/users' && req.method === 'POST') {
      const body = await req.json();
      return Response.json({ id: 1, ...body }, { status: 201 });
    }

    return new Response('Not Found', { status: 404 });
  },
  error(error) {
    return new Response(`Error: ${error.message}`, { status: 500 });
  },
});

console.log('服务器运行在 http://localhost:3000');

使用 Hono（推荐用于 API）

import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { logger } from 'hono/logger';

const app = new Hono();

app.use('*', logger());
app.use('/api/*', cors());

app.get('/api/users', (c) => {
  return c.json([{ id: 1, name: 'John' }]);
});

app.post('/api/users', async (c) => {
  const body = await c.req.json();
  return c.json({ id: 1, ...body }, 201);
});

export default app;

文件 I/O

// 读取文件（返回字符串或 ArrayBuffer）
const text = await Bun.file('data.txt').text();
const json = await Bun.file('data.json').json();
const buffer = await Bun.file('image.png').arrayBuffer();

// 写入文件
await Bun.write('output.txt', 'Hello World');
await Bun.write('data.json', JSON.stringify(data));

// 流式处理大文件
const file = Bun.file('large.csv');
const stream = file.stream();

for await (const chunk of stream) {
  process.stdout.write(chunk);
}

// 文件元数据
const file = Bun.file('data.txt');
console.log(file.size);  // 字节数
console.log(file.type);  // MIME 类型

SQLite（内置）

import { Database } from 'bun:sqlite';

const db = new Database('app.db');

// 创建表
db.run(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE
  )
`);

// 预处理语句（推荐）
const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
insert.run('John', 'john@example.com');

const select = db.prepare('SELECT * FROM users WHERE id = ?');
const user = select.get(1);

// 查询所有
const all = db.prepare('SELECT * FROM users').all();

// 事务
db.transaction(() => {
  insert.run('Alice', 'alice@example.com');
  insert.run('Bob', 'bob@example.com');
})();

环境变量

// .env 文件自动加载
const apiKey = Bun.env.API_KEY;
const port = Bun.env.PORT ?? '3000';

// process.env 同样有效
const nodeEnv = process.env.NODE_ENV;

Shell 命令

import { $ } from 'bun';

// 简单命令
const result = await $`ls -la`;
console.log(result.stdout.toString());

// 使用变量（自动转义）
const filename = 'my file.txt';
await $`cat ${filename}`;

// 管道
const files = await $`ls`.text();
const count = await $`echo ${files} | wc -l`.text();

// 错误处理
try {
  await $`exit 1`;
} catch (error) {
  console.error('命令执行失败:', error.exitCode);
}

配置 (bunfig.toml)

# bunfig.toml

[install]
# 注册表
registry = "https://registry.npmjs.org"

# CI 环境中的锁定文件冻结
frozenLockfile = true

[run]
# 脚本使用的 shell
shell = "bash"

[test]
# 测试配置
coverage = true
coverageDir = "coverage"

Node.js 兼容性

// 大多数 Node.js API 可用
import { readFile } from 'fs/promises';
import { createServer } from 'http';
import path from 'path';

// 一些差异
import.meta.dir;  // __dirname 等效
import.meta.file; // __filename 等效

// 检查运行时
const isBun = typeof Bun !== 'undefined';

何时不应使用此技能

反模式

快速故障排除

性能对比

生产就绪性

# Dockerfile
FROM oven/bun:1 AS base
WORKDIR /app

# 安装依赖
FROM base AS deps
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# 构建
FROM base AS build
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN bun run build

# 生产环境
FROM base AS production
COPY --from=build /app/dist ./dist
COPY --from=build /app/package.json ./

USER bun
EXPOSE 3000
CMD ["bun", "run", "dist/index.js"]

检查清单

• Bun 已安装 (v1.0+)
• bunfig.toml 已配置
• 使用 bun:test 的测试套件
• 构建脚本已配置
• 生产环境使用 Docker 多阶段构建
• npm 包兼容性已验证

参考文档

• Bun 文档

深度知识：使用 mcp__documentation__fetch_docs 并指定技术参数：bun 以获取全面的文档。

每周安装次数

1

代码仓库

claude-dev-suit…ev-suite

首次出现

3 天前

安全审计

Gen Agent Trust HubPassSocketPassSnykWarn

安装于

amp1

cline1

openclaw1

opencode1

cursor1

kimi-cli1

Workspaces

// package.json
{
  "workspaces": ["packages/*"]
}



# Install all workspace deps
bun install

# Run in specific workspace
bun run --filter @myorg/api build

Bundler

// Build for production
await Bun.build({
  entrypoints: ['./src/index.ts'],
  outdir: './dist',
  target: 'node',        // 'browser' | 'bun'
  minify: true,
  sourcemap: 'external',
  splitting: true,       // Code splitting
  format: 'esm',         // 'cjs' | 'esm'
});

// CLI
bun build ./src/index.ts --outdir ./dist --minify

Build Config

// bunfig.toml alternative - build.ts
const result = await Bun.build({
  entrypoints: ['./src/index.tsx'],
  outdir: './dist',
  target: 'browser',
  minify: {
    whitespace: true,
    identifiers: true,
    syntax: true,
  },
  define: {
    'process.env.NODE_ENV': '"production"',
  },
  external: ['react', 'react-dom'],
  loader: {
    '.png': 'file',
    '.svg': 'text',
  },
});

if (!result.success) {
  console.error('Build failed:', result.logs);
  process.exit(1);
}

Test Runner

// math.test.ts
import { describe, it, expect, beforeAll, mock } from 'bun:test';

describe('math', () => {
  it('adds numbers', () => {
    expect(1 + 2).toBe(3);
  });

  it('handles async', async () => {
    const result = await fetchData();
    expect(result).toBeDefined();
  });
});

// Mocking
const mockFn = mock(() => 42);
mockFn();
expect(mockFn).toHaveBeenCalled();

// Module mocking
mock.module('./config', () => ({
  apiUrl: 'http://test.local',
}));



# Run tests
bun test

# Watch mode
bun test --watch

# Coverage
bun test --coverage

# Filter
bun test --filter "user"

HTTP Server

// Native Bun server (fastest)
Bun.serve({
  port: 3000,
  fetch(req) {
    const url = new URL(req.url);

    if (url.pathname === '/api/health') {
      return Response.json({ status: 'ok' });
    }

    if (url.pathname === '/api/users' && req.method === 'POST') {
      const body = await req.json();
      return Response.json({ id: 1, ...body }, { status: 201 });
    }

    return new Response('Not Found', { status: 404 });
  },
  error(error) {
    return new Response(`Error: ${error.message}`, { status: 500 });
  },
});

console.log('Server running on http://localhost:3000');

With Hono (recommended for APIs)

import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { logger } from 'hono/logger';

const app = new Hono();

app.use('*', logger());
app.use('/api/*', cors());

app.get('/api/users', (c) => {
  return c.json([{ id: 1, name: 'John' }]);
});

app.post('/api/users', async (c) => {
  const body = await c.req.json();
  return c.json({ id: 1, ...body }, 201);
});

export default app;

File I/O

// Read file (returns string or ArrayBuffer)
const text = await Bun.file('data.txt').text();
const json = await Bun.file('data.json').json();
const buffer = await Bun.file('image.png').arrayBuffer();

// Write file
await Bun.write('output.txt', 'Hello World');
await Bun.write('data.json', JSON.stringify(data));

// Stream large files
const file = Bun.file('large.csv');
const stream = file.stream();

for await (const chunk of stream) {
  process.stdout.write(chunk);
}

// File metadata
const file = Bun.file('data.txt');
console.log(file.size);  // bytes
console.log(file.type);  // MIME type

SQLite (Built-in)

import { Database } from 'bun:sqlite';

const db = new Database('app.db');

// Create table
db.run(`
  CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE
  )
`);

// Prepared statements (recommended)
const insert = db.prepare('INSERT INTO users (name, email) VALUES (?, ?)');
insert.run('John', 'john@example.com');

const select = db.prepare('SELECT * FROM users WHERE id = ?');
const user = select.get(1);

// Query all
const all = db.prepare('SELECT * FROM users').all();

// Transaction
db.transaction(() => {
  insert.run('Alice', 'alice@example.com');
  insert.run('Bob', 'bob@example.com');
})();

Environment Variables

// .env file loaded automatically
const apiKey = Bun.env.API_KEY;
const port = Bun.env.PORT ?? '3000';

// process.env also works
const nodeEnv = process.env.NODE_ENV;

Shell Commands

import { $ } from 'bun';

// Simple command
const result = await $`ls -la`;
console.log(result.stdout.toString());

// With variables (auto-escaped)
const filename = 'my file.txt';
await $`cat ${filename}`;

// Piping
const files = await $`ls`.text();
const count = await $`echo ${files} | wc -l`.text();

// Error handling
try {
  await $`exit 1`;
} catch (error) {
  console.error('Command failed:', error.exitCode);
}

Configuration (bunfig.toml)

# bunfig.toml

[install]
# Registry
registry = "https://registry.npmjs.org"

# Frozen lockfile in CI
frozenLockfile = true

[run]
# Shell for scripts
shell = "bash"

[test]
# Test configuration
coverage = true
coverageDir = "coverage"

Node.js Compatibility

// Most Node.js APIs work
import { readFile } from 'fs/promises';
import { createServer } from 'http';
import path from 'path';

// Some differences
import.meta.dir;  // __dirname equivalent
import.meta.file; // __filename equivalent

// Check runtime
const isBun = typeof Bun !== 'undefined';

When NOT to Use This Skill

Anti-Patterns

Quick Troubleshooting

Performance Comparison

Production Readiness

# Dockerfile
FROM oven/bun:1 AS base
WORKDIR /app

# Install deps
FROM base AS deps
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# Build
FROM base AS build
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN bun run build

# Production
FROM base AS production
COPY --from=build /app/dist ./dist
COPY --from=build /app/package.json ./

USER bun
EXPOSE 3000
CMD ["bun", "run", "dist/index.js"]

Checklist

• Bun installed (v1.0+)
• bunfig.toml configured
• Test suite with bun:test
• Build script configured
• Docker multi-stage for production
• npm package compatibility verified

Reference Documentation

• Bun Docs

Deep Knowledge : Use mcp__documentation__fetch_docs with technology: bun for comprehensive documentation.

Weekly Installs

1

Repository

claude-dev-suit…ev-suite

First Seen

3 days ago

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

amp1

cline1

openclaw1

opencode1

cursor1

kimi-cli1