先换 bun install,别急着换 runtime:Bun 替代 Node.js 的四条边界

2 阅读11分钟

2026 年,Bun 已经能替代 npm 安装和部分测试脚本,但还没有替代 Node.js 的运行时位置。

适用读者:前端开发、Node.js 后端开发 版本/时间边界:Bun 1.4.4(2026-10-22)、Node.js 26.13.1 LTS(截至 2026-11-13) 最后核实日期:2026-11-13

本文未在真实项目运行验证;性能与兼容结论均来自公开资料,厂商自测的部分会单独标注。


过去一年,关于 Bun 的讨论从“能不能用”变成了“什么时候全面替换 Node”。但把版本、兼容页和平台文档摊开看,答案不是二选一。Bun 的替代发生在四个不同层面:工具链、新项目、存量服务、语言与生态。每一层的成本、证据和回滚方式都不一样。

本文按这四条边界拆开,给出一套可以落地的判断顺序。

1. 先给结论:Bun 替代的是工作流位置,不是 Node 这个名字

先把问题拆成四个:本地工具链要不要换?新项目要不要用 Bun runtime?存量服务能不能迁?TypeScript 与生态标准会不会跟着换?这四个问题的答案并不相同。

判断时至少要区分四类信号,不能混着用:

  • 讨论热度:检索中能看到大量中文文章,但热度不是成熟度,也不能替代兼容性证据。
  • 增长速度:npm 上 bun 包近一月约 2,186 万次下载[11],官方称 CLI 月下载超过 2,200 万[5]。下载量是代理指标,不等于用户数或企业采用率。
  • 工程成熟度:Bun 当前稳定版是 1.4.4[1];1.4 起主线实现改为 Rust[2][5];官方兼容页已经按 Node.js 26 逐模块标注[3]。
  • 生产采用:Claude Code、Prisma Compute、X、Midjourney、Tailwind CLI 等有官方或合作方披露[4][5];Vercel 的 Bun Runtime 仍是 Beta[9];本次检索没有找到独立的行业采用调查。

这四类信号放在一起,结论只能是:Bun 已经在部分工作流里可用,但不能用一个“替代/不替代”回答所有场景。State of JS 2025 里 Bun 的满意度是 91%,进入 S 档[10],但这是自选样本的满意度,不是采用率。如果你只记一个判断:Bun 的成熟度足以支撑工具链试点,但还不足以让所有存量服务无脑切换;这正是后文四条边界要展开的内容。

flowchart TD
    Q[你要换的是哪一层] --> A[工具链]
    Q --> B[构建与 TS]
    Q --> C[新项目与 CLI]
    Q --> D[存量核心服务]
    A --> A1[低风险,立刻可试]
    B --> B1[中风险,逐步替换]
    C --> C1[可控风险,小范围试]
    D --> D1[高风险,先验证再换]

图 1 是示意:工具链和构建属于本地开发,新项目/CLI 和存量核心属于生产流量;越往下,迁移成本和影响范围越大。替代顺序建议从工具链开始,不要一步跨到存量核心。

2. 边界一:工具链可以换,运行时别一起换

最容易看到收益、也最容易回滚的一层,是本地工具链。bun install 替代 npm/pnpm 安装,bun test 替代部分 Jest/Vitest 脚本,bun run 替代 npm scripts;1.4.4 还加入了 bun fmt,并继续改进 bun check[1]。这些动作发生在开发机和 CI,不直接改变线上进程,回滚成本最低。

但收益要按口径看。Bun 官方给出的安装、启动、测试数据都是厂商自测,硬件和脚本公开,但没有独立复现[1][2]。你能确认的是“在自己的 CI 上是否更快”,不是“一定快 15 倍”。另外,1.4 对新 monorepo 默认使用 isolated linker[2],已有 lockfile 的项目会保留原行为;迁移 lockfile 前先备份,别在同一个分支里同时改包管理器和运行时。

一个低风险试点可以这样排:

  • 第 1 周,只换安装:CI 增加 bun install --frozen-lockfile,对比安装耗时、缓存命中、私有源认证;保留原来的 npm/pnpm 命令。
  • 第 2 周,只换测试和脚本:跑 bun test 与 bun run build,对比通过率、快照、覆盖率;生产 runtime 继续用 Node。
  • 两周后,只根据数据决定是否扩大范围:不用“本地感觉快”作为依据。
# 示例命令,尚未在真实项目运行验证
bun install --frozen-lockfile
bun test
bun run build

回滚线很简单:保留原包管理器命令、原 lockfile 和 Node 运行时镜像;CI 双跑一周,确认没有隐性差异后再移除旧路径。

flowchart TD
    A[现有 Node 项目] --> B{先换哪一步}
    B -->|只换工具链| C[bun install 与 CI 缓存]
    C --> D{CI、锁文件、构建通过}
    D -->|否| R[回滚到原包管理器]
    D -->|是| E[bun test 与 bun run 脚本]
    E --> F{测试稳定且可回滚}
    F -->|否| R
    F -->|是| G[生产 runtime 继续用 Node]
    G --> H[新项目再评估 Bun runtime]

图 2 的重点不是“怎么迁”,而是“在哪一步停”。工具链换完就停,是 2026 年更稳妥的默认策略。

3. 边界二:新项目可以试,存量服务先过检查表

新项目、CLI、内部工具是 Bun 更舒服的场景。单文件可执行、Bun.serve、内置 bundler/test/package manager,适合从零开始、没有历史包袱的项目[2][4]。平台侧,Vercel 提供 Bun Runtime;Vercel 文档(更新于 2026-08-24)仍把它标为 Beta,其中 1.4.x 指向 Rust 版,1.x 当时仍指向 1.3.14[9]。想用新版本,必须在 vercel.json 里显式写 1.4.x,否则你可能以为在跑 1.4,实际还是 1.3。

官方披露的采用包括 Claude Code、Prisma Compute、X、Midjourney、Tailwind CLI 等[4][5]。这些是明确的采用信号,但都是厂商或合作方口径,不能推断为行业普遍采用。

存量服务是另一回事。迁移前至少过一遍下面 6 项;任何一项不通过,都先别把核心流量切过去。

表 1:存量服务迁移前检查表

检查项为什么不通过怎么办
原生 addon / Node-API预编译 .node 需要匹配平台与 NODE_MODULE_VERSION;依赖 V8 C++ API 的包可能直接报错[3]留在 Node,或换纯 JS 实现
async_hooks / APMBun 的 createHook、executionAsyncId 等是 stub,依赖它们的追踪可能失真[3]换观测方案,或继续用 Node
worker_threads / clusterresourceLimits 被忽略;cluster 的 HTTP 多进程负载均衡仅 Linux 支持[3]改架构,或只在 Linux 上试
v8.serialize / V8 专有行为Bun 用 JavaScriptCore 的序列化格式,跨运行时数据不兼容[3]不要混跑;统一序列化协议
TLS / 协议跨进程 TLS 会话恢复、OCSP stapling 等仍缺失[3]需要长连接/会话复用时留在 Node
平台与部署node:sea 未实现;部分平台缺少自动 source map 或 node:http/https 指标[3][9]改用 bun build --compile,或留在 Node

这张表不是“Bun 不行”,而是“先确认你的依赖有没有踩到这些点”。如果 6 项都过,存量服务可以按接口粒度局部替换;如果有一项是核心链路,迁移的收益很可能小于验证成本。

4. 边界三:API 有了,不等于行为一致

Bun 1.4 报告 Node.js 26.3.0 测试套件新增 1,517 个通过测试:node:http、fs、cluster、timers、zlib、vm、stream 约 97% 通过,events、trace_events、sqlite 100%,quic 99%[2]。这些数字很容易被读成“Bun 已经兼容 97%”,但官方紧接着写的是:尚未 100% 兼容[2]。

97% 是若干核心模块的测试通过率,不是整体兼容度。更关键的是,测试通过不等于行为一致。兼容页里一些“已实现”的模块仍然列出差异:async_hooks 的 hook 不触发、worker_threads 忽略资源限制、cluster 的 HTTP 负载均衡只在 Linux 成立、v8.serialize 的 wire format 与 V8 不同、TLS 会话不能跨进程恢复、node:sea 完全没实现[3]。再比如 node:console 在 Bun 里直接写 stdout/stderr,替换 process.stdout.write 不一定能捕获输出;node:os 的 userInfo() 从环境变量读取用户名和 home,而不是 passwd 数据库[3]。这些差异不会出现在“模块已实现”这四个字里。

所以排查顺序应该是:先看依赖树里有没有原生模块和 APM,再看有没有 worker_threads、cluster、v8.serialize、TLS 会话,最后看平台是否依赖 Node 专有指标。按依赖类型查,比逐条 API 对照有效得多。

Rust 重写也值得放在这个框架里看:官方说它修复了一批内存泄漏和崩溃,但也披露重写引入了 19 个已知回归,且已修复[5]。这说明团队在系统性处理稳定性,不等于“重写完成 = 稳定性已经被证明”。

一句话:API 兼容解决“能不能跑”,行为一致才决定“能不能上线”。

5. 边界四:TypeScript 差距在缩小,但没消失

很多人对 Bun 的第一印象是“Node 不能跑 TypeScript”。这句话在 2026 年已经不准确。Node.js 26 的类型剥离已经稳定,默认可执行只含可擦除语法的 .ts;--experimental-transform-types 也被移除[7][8]。

但它不是完整的 TypeScript 工具链:.tsx 不支持;enum、带运行时代码的 namespace、参数属性、import alias、装饰器都不支持;tsconfig.json 被忽略,paths 不生效;node_modules 里的 TS 会被拒绝[8]。这也解释了为什么很多团队在 Node 26 上仍然保留 tsx:不是 Node 不能跑 TS,而是项目用到了类型剥离不支持的语法。

Bun 仍然是更完整的默认体验:.ts/.tsx、enum、装饰器、tsconfig、bundler、test runner 一起提供[1][2][12]。对 TS-heavy 的 monorepo、React/JSX 项目,Bun 的优势仍在;对只写几个脚本或轻量服务的团队,Node 26 已经够用,不必为了 TS 迁 Bun。

表 2:Node.js 26 与 Bun 1.4.4 的 TypeScript 能力对照

能力Node.js 26Bun 1.4.4
直接运行 .ts支持,限可擦除语法[8]支持[1]
.tsx / JSX不支持[8]支持[1][2]
enum / 运行时代码 namespace不支持[8]支持[2]
装饰器不支持[8]支持标准装饰器[2]
tsconfig / paths忽略[8]读取 tsconfig,支持常见 paths 配置[13]
内置 bundler / test有 node:test,无内置 bundlerbun build / bun test[1]

Node 也没有停在原地。Node 27 从 2026-10-29 进入 Alpha,并且从 27 开始改为每年一个大版本、每个大版本都进入 LTS[6]。这意味着“Node 不会补 TS/工具链”的假设不成立;更准确的判断是:Node 在补语言层,Bun 在补工具链一体化。

6. 怎么选:一张决策表,三条回滚线

表 3:场景化决策表(作者判断,按团队约束调整)

你的场景建议先验证回滚条件
只想让 CI 快一点换 bun install / bun test锁文件、私有源、缓存、CI 通过率恢复原包管理器命令与 lockfile
新项目 / CLI / 内部工具可以试 Bun runtime平台 Beta、版本 pin、日志/指标/追踪换回 Node 镜像,保留同一容器接口
存量服务先局部替换,不切核心流量表 1 的 6 项 + 压测 + 追踪双跑一周,按接口切回
强依赖 Node 行为暂不换APM、原生 addon、v8.serialize、TLS 会话保持 Node,不引入第二套运行时

反过来说,强依赖 APM 的 async_hooks 上下文、原生 addon、V8 序列化格式或 TLS 跨进程会话的项目,暂时不该选 Bun。这不是保守,而是把验证成本留在可承受的一侧。

三条回滚线要提前写进方案:

  1. 运行时镜像:Bun 与 Node 各构建一个镜像,入口和环境变量一致,切换只改 tag。
  2. CI 双跑:同一套测试在 Node 和 Bun 各跑一遍,差异进入白名单,而不是“先上线再看”。
  3. 观测对齐:日志字段、指标名、追踪上下文先对齐;否则迁移后你看到的“变快”可能只是没采到数据。

回到标题:Bun 没有取代 Node.js,它先替代了工具链里的 npm 和部分测试脚本。2026 年更合理的策略是分工——本地和 CI 先用 Bun 换效率,新项目和 CLI 小范围试 runtime,存量核心服务按检查表决定要不要动。如果你的项目强依赖 APM 的 async_hooks 上下文,或者团队没有维护双运行时的预算,“暂不换”不是保守,而是正确决策。

如果你只想做一件事:下周先把 bun install 和 bun test 放进一条非核心流水线,保留 Node 运行时。这个动作的收益可测,回滚也最便宜。


参考资料

  1. Bun v1.4.4 — Bun,2026-10-22 — bun.com/blog/bun-v1…
  2. Bun 1.4 — Bun,2026-08-20 — bun.com/blog/bun-v1…
  3. Node.js Compatibility — Bun,访问于 2026-11-13 — bun.com/docs/runtim…
  4. Bun is joining Anthropic — Bun,2025-12-02 — bun.com/blog/bun-jo…
  5. Rewriting Bun in Rust — Bun,2026-07-08 — bun.com/blog/bun-in…
  6. Node.js Releases — Node.js,访问于 2026-11-13 — nodejs.org/en/about/pr…
  7. Node.js 26.0.0 (Current) — Node.js,2026-05-05 — nodejs.org/en/blog/rel…
  8. Modules: TypeScript — Node.js v26.13.1 文档,访问于 2026-11-13 — nodejs.org/api/typescr…
  9. Using the Bun Runtime with Vercel Functions — Vercel,更新于 2026-08-24 — vercel.com/docs/functi…
  10. State of JavaScript 2025 — Devographics,2026 — 2025.stateofjs.com/en-US/libra…
  11. npm downloads for bun — npm registry,统计窗口 2026-10-13 至 2026-11-11 — api.npmjs.org/downloads/p…
  12. TypeScript — Bun,访问于 2026-11-13 — bun.com/docs/runtim…
  13. Re-map import paths — Bun,访问于 2026-11-13 — bun.com/docs/guides…