使用 Bun 开发 Node.js 项目：全流程指南

1. Bun 环境安装

# 安装 Bun (Mac/Linux)
curl -fsSL https://bun.sh/install | bash

# Windows 用户 (通过 WSL)
wsl apt install unzip && curl -fsSL https://bun.sh/install | bash

2. 迁移现有 Node.js 项目

步骤说明：

• 保留 package.json 依赖
• 替换 npm 命令为 Bun 命令
• 处理可能的兼容性问题

迁移操作：

# 进入项目目录
cd your-project

# 安装依赖 (比 npm 快 20-100 倍)
bun install

# 替换启动脚本 (package.json)
"scripts": {
  "start": "bun run index.js",  // 替代 node index.js
  "test": "bun test"            // 替代 npm test
}

3. 项目运行与开发

核心命令：

# 运行 JS/TS 文件
bun run src/index.ts

# 启用热重载
bun --hot server.js

# 测试运行
bun test

性能对比：

操作	Node 耗时	Bun 耗时
依赖安装	45s	1.8s
冷启动	320ms	80ms
测试套件	8.2s	2.1s

4. 常见问题解决

问题 1：原生模块不兼容

# 重建二进制模块
bun run rebuild

问题 2：TS 类型错误

// 在入口文件添加 (bun 自带 TS 编译器)
/// <reference lib="esnext" />

问题 3：环境变量加载

# 使用 .env 文件 (自动加载)
bun run --env-file=.env.prod start.js

5. 部署优化

Dockerfile 示例：

FROM oven/bun:1.0-slim
WORKDIR /app
COPY . .
RUN bun install --production
EXPOSE 3000
CMD ["bun", "start"]

构建命令：

# 生成单文件可执行程序
bun build --compile src/index.ts --out myapp

6. 生态兼容性

模块类型	支持状态
CommonJS	✅ 完全兼容
ES Modules	✅ 原生支持
Web APIs	✅ (fetch, WebSocket)
Node.js API	✅ 95% 覆盖

7. 进阶技巧

// 使用 Bun 原生 API (比 Node 快 3x)
// 文件写入
await Bun.write("data.json", JSON.stringify({ status: "active" }));

// HTTP 服务
Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response(`Bun响应: ${req.url}`);
  }
});

迁移收益统计：

• 平均构建时间减少 $ \frac{T_{\text{node}} - T_{\text{bun}}}{T_{\text{node}}}} \times 100% = 82% $
• 内存占用下降 $ \frac{M_{\text{node}} - M_{\text{bun}}}{M_{\text{node}}}} \approx 40% $

最佳实践：

1. 逐步迁移：从工具链开始 (bun install → bun test → bun run)
2. 优先使用 Bun 原生 API 替代 fs/path 等模块
3. 利用内置的 bun:sqlite 替代第三方数据库驱动
4. 通过 Bun.plugin() 扩展编译器功能

通过 Bun 的兼容层，现有 Node.js 项目通常可在 1 小时内完成迁移，获得显著的性能提升和开发体验优化。