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 / APM | Bun 的 createHook、executionAsyncId 等是 stub,依赖它们的追踪可能失真[3] | 换观测方案,或继续用 Node |
worker_threads / cluster | resourceLimits 被忽略;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 26 | Bun 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,无内置 bundler | bun 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。这不是保守,而是把验证成本留在可承受的一侧。
三条回滚线要提前写进方案:
- 运行时镜像:Bun 与 Node 各构建一个镜像,入口和环境变量一致,切换只改 tag。
- CI 双跑:同一套测试在 Node 和 Bun 各跑一遍,差异进入白名单,而不是“先上线再看”。
- 观测对齐:日志字段、指标名、追踪上下文先对齐;否则迁移后你看到的“变快”可能只是没采到数据。
回到标题:Bun 没有取代 Node.js,它先替代了工具链里的 npm 和部分测试脚本。2026 年更合理的策略是分工——本地和 CI 先用 Bun 换效率,新项目和 CLI 小范围试 runtime,存量核心服务按检查表决定要不要动。如果你的项目强依赖 APM 的 async_hooks 上下文,或者团队没有维护双运行时的预算,“暂不换”不是保守,而是正确决策。
如果你只想做一件事:下周先把 bun install 和 bun test 放进一条非核心流水线,保留 Node 运行时。这个动作的收益可测,回滚也最便宜。
参考资料
- Bun v1.4.4 — Bun,2026-10-22 — bun.com/blog/bun-v1…
- Bun 1.4 — Bun,2026-08-20 — bun.com/blog/bun-v1…
- Node.js Compatibility — Bun,访问于 2026-11-13 — bun.com/docs/runtim…
- Bun is joining Anthropic — Bun,2025-12-02 — bun.com/blog/bun-jo…
- Rewriting Bun in Rust — Bun,2026-07-08 — bun.com/blog/bun-in…
- Node.js Releases — Node.js,访问于 2026-11-13 — nodejs.org/en/about/pr…
- Node.js 26.0.0 (Current) — Node.js,2026-05-05 — nodejs.org/en/blog/rel…
- Modules: TypeScript — Node.js v26.13.1 文档,访问于 2026-11-13 — nodejs.org/api/typescr…
- Using the Bun Runtime with Vercel Functions — Vercel,更新于 2026-08-24 — vercel.com/docs/functi…
- State of JavaScript 2025 — Devographics,2026 — 2025.stateofjs.com/en-US/libra…
- npm downloads for
bun— npm registry,统计窗口 2026-10-13 至 2026-11-11 — api.npmjs.org/downloads/p… - TypeScript — Bun,访问于 2026-11-13 — bun.com/docs/runtim…
- Re-map import paths — Bun,访问于 2026-11-13 — bun.com/docs/guides…