使用Bun执行 Node.js 代码非常简单因为 Bun 设计为与 Node.js 高度兼容。以下是完整的使用指南1. 安装 Bunbash复制# macOS / Linux curl -fsSL https://bun.sh/install | bash # Windows (通过 WSL) curl -fsSL https://bun.sh/install | bash # 或通过 npm 安装 npm install -g bun2. 直接执行 Node.js 文件Bun 可以直接运行.js、.ts、.jsx、.tsx文件无需额外配置bash复制# 原本用 node 运行 node server.js # 改用 bun 运行直接替换 bun server.js # 运行 TypeScript 文件无需 ts-node bun server.ts # 运行带有环境变量的文件 bun run server.js3. 执行 package.json 中的脚本JSON复制{ scripts: { start: node server.js, dev: nodemon server.js, build: tsc } }执行方式bash复制# 运行 start 脚本bun 会自动识别并使用 bun 执行 bun run start # 或简写仅用于 package.json 脚本 bun start # 运行开发服务器会自动处理 nodemon bun run dev4. 兼容性与差异✅ 完全兼容的 Node.js APIfs,path,http,https等核心模块Buffer,process,globalCommonJS (require) 和 ESM (import)⚠️ 需要注意的差异JavaScript复制// 1. 环境变量加载 // Bun 会自动加载 .env 文件无需 dotenv // Node.js 需要: require(dotenv).config() console.log(process.env.DB_HOST) // 自动可用 // 2. 文件读取Bun 提供更快的方式 // Node.js 方式仍兼容 const fs require(fs); const data fs.readFileSync(./file.txt, utf8); // Bun 原生方式更快 const file Bun.file(./file.txt); const text await file.text(); // 3. HTTP 服务器两者都支持 // Node.js 方式 const http require(http); http.createServer((req, res) res.end(OK)).listen(3000); // Bun 原生方式推荐 Bun.serve({ port: 3000, fetch(req) { return new Response(OK); } });5. 完整迁移示例原 Node.js 项目结构bash复制my-project/ ├── package.json ├── server.js └── .env迁移步骤bash复制# 1. 进入项目目录 cd my-project # 2. 删除 node_modules可选但推荐 rm -rf node_modules package-lock.json # 3. 使用 bun 安装依赖自动创建 bun.lockb bun install # 4. 直接运行无需修改代码 bun server.js6. 高级用法作为解释器ShebangJavaScript复制#!/usr/bin/env bun // 文件顶部添加 shebang赋予执行权限后可直接运行 console.log(Hello from Bun!);bash复制chmod x script.js ./script.js # 直接执行无需 bun 前缀监视模式热重载bash复制# 开发模式文件变化自动重启比 nodemon 更快 bun --watch server.js # 或 bun run --watch server.js运行测试兼容 Jestbash复制# 如果项目使用 Jest bun test # 或运行特定测试文件 bun test sum.test.js7. 性能对比示例JavaScript复制// fibonacci.js - 计算密集型任务 function fib(n) { return n 2 ? n : fib(n - 1) fib(n - 2); } console.log(fib(40));bash复制time node fibonacci.js # Node.js: ~2.5s time bun fibonacci.js # Bun: ~1.2s快 2 倍8. 常见问题解决遇到原生模块问题Native Addons如果项目依赖 C 原生模块如bcrypt,sqlite3bash复制# 尝试重新编译 bun install --force # 或使用兼容性标志 bun --bun server.js # 强制使用 Bun 运行时而非 Node 兼容模式指定 Node.js 兼容性模式bash复制# 如果某些库检测 process.versions.node bun --nodejs-compat server.js调试bash复制# 开启调试模式类似 node --inspect bun --inspect server.js # 查看详细错误 bun --verbose server.js9. 生产环境部署dockerfile复制# Dockerfile FROM oven/bun:latest WORKDIR /app COPY package.json bun.lockb ./ RUN bun install --production COPY . . EXPOSE 3000 CMD [bun, server.js]总结表格场景Node.js 命令Bun 命令运行文件node app.jsbun app.js安装依赖npm installbun install运行脚本npm run devbun run dev开发模式nodemon app.jsbun --watch app.jsTypeScriptts-node app.tsbun app.ts执行测试npm testbun test核心优势Bun 几乎零成本替换 Node.js多数项目只需将node改为bun即可同时获得更快的启动速度和运行性能。Bun是一个用Zig编写的高性能 JavaScript 运行时核心优势可以概括为极速、一体化、零配置。以下是详细对比1. 极致性能比 Node.js 快 3-10 倍启动速度冷启动Bun 的启动时间约为10-30msNode.js 约为200-400msTypeScript 免编译直接运行.ts文件无需ts-node或预编译运行性能JavaScript复制// 计算斐波那契数列 (fib(40)) Node.js: ~2,800ms Deno: ~2,600ms Bun: ~1,200ms ← 快 2-3 倍包管理速度表格操作npmyarnpnpmBun安装依赖 (Next.js 项目)45s28s15s3sbash复制# Bun 使用全局模块缓存和硬链接 bun install # 比 npm install 快 20-50 倍2. 一体化工具链All-in-one ToolkitBun 内置了 Node.js 生态中需要多个工具才能实现的功能表格功能Node.js 方案Bun 方案包管理npm/yarn/pnpmbun install(内置)打包Webpack/Vite/esbuildbun build(基于 esbuild更快)测试Jest/Vitestbun test(Jest 兼容 API)TypeScriptts-node 配置原生支持零配置环境变量dotenv 包自动加载.envSQLitebetter-sqlite3 等bun:sqlite(内置高性能)HTTP 服务器Express/FastifyBun.serve()(内置类 Web 标准 API)3. 原生 API 设计更现代文件 I/O比 Node.js 简洁JavaScript复制// Node.js const fs require(fs).promises; const data await fs.readFile(./file.txt, utf8); // Bun - 更简洁且性能更高 const file Bun.file(./file.txt); const text await file.text(); // 返回 Promise const json await file.json(); // 直接解析 JSONHTTP 服务器高性能原生实现JavaScript复制// Bun - 内置无需框架支持 WebSocket Bun.serve({ port: 3000, websocket: { message(ws, message) { ws.send(Echo: ${message}); } }, fetch(request) { return new Response(Hello World); } }); // 性能~120k req/s (Node.js Express: ~20k req/s)4. 对 Node.js 的兼容性Bun 设计目标是直接替换 Node.js✅ 支持require()和import✅ 支持node_modules和package.json✅ 核心模块兼容 (fs,path,crypto,http等)✅ 支持 90% 的 Node.js APIbash复制# 现有 Node.js 项目迁移通常只需改命令 node server.js # 原命令 bun server.js # 替换后90% 情况无需改代码5. 内置 SQLite超高速Bun 内置了用 Zig 重写的高性能 SQLite 驱动比流行的better-sqlite3更快JavaScript复制import { Database } from bun:sqlite; const db new Database(app.db); const query db.query(SELECT * FROM users WHERE age $age); const results query.all({ $age: 18 }); // 比 better-sqlite3 快 2-3 倍6. 内存占用更低运行相同应用时Bun 的内存占用通常比 Node.js 少30-50%Express 应用Node.js ~120MB vs Bun ~60MBWebSocket 服务器Node.js ~200MB vs Bun ~80MB这对容器化部署Docker/K8s特别有利可以部署更多实例。7. 开发体验DX优化热重载内置bash复制# Node.js 需要安装 nodemon nodemon server.js # Bun 原生支持更快 bun --watch server.js自动加载环境变量bash复制# 无需代码中 require(dotenv).config() # Bun 自动读取 .env 文件 bun run server.js # process.env.API_KEY 直接可用更好的错误提示Bun 的错误堆栈更清晰会高亮显示问题代码并给出修复建议。8. 跨平台 FFI调用原生库Bun 的 FFIForeign Function Interface比 Node.js 的node-ffi更快且更易用JavaScript复制import { dlopen, FFIType } from bun:ffi; const lib dlopen(libsqlite3.dylib, { sqlite3_open: { args: [FFIType.cstring], returns: FFIType.int } });适用场景总结表格场景推荐度说明CLI 工具开发⭐⭐⭐⭐⭐启动极快适合命令行工具微服务/API 网关⭐⭐⭐⭐⭐高并发、低内存占用脚本/自动化⭐⭐⭐⭐⭐替代 Python/Bash 脚本前端工具链⭐⭐⭐⭐打包、测试一体化复杂企业级后端⭐⭐⭐需验证特定依赖兼容性机器学习/AI⭐⭐Python 生态仍更完善总结选择 Bun 如果你厌倦了配置复杂的 Node.js 工具链需要极致的启动速度和运行性能想要一个 batteries included 的解决方案构建云原生/边缘计算应用Cloudflare Workers 兼容暂缓迁移如果项目重度依赖特定的原生 Node.js 模块C addons需要特定的 Node.js 调试工具如某些 APM 工具团队对新技术采纳持保守态度Bun 目前v1.0已足够稳定用于生产环境特别适合新项目或性能敏感型应用。