掌握 Bun 1.2 Monorepo Workspaces：替代 Turborepo 的实用 workspaces:* 设置（2026）

一份用 Bun 1.2 替代 Turborepo 的实用 monorepo 设置指南。内容涵盖运行 workspaces:* 的实战模式、稳定 CI、分阶段发布，以及隔离故障传播。

Bun 1.2 与 Turborepo 在 monorepo 中直接对比时，不仅能显著降低速度相关成本，也能降低运营稳定性成本。很多团队太晚才意识到，管理故障范围比采用新功能更重要。本指南的目标是建立一套无需大规模迁移即可立即应用于真实工作的标准。它不要求一开始就具备高级编排能力，而是通过 workspaces: 主动配置按变更范围执行。首先，固定文件夹结构。将 apps 和 packages 分开，并把每个 package 绑定到所有者和责任 SLA。当 apps 负责部署、packages 负责复用时，评审流程会更清晰。根 package.json 应保持简洁。只定义 workspaces，并将 scripts 保持在最小集合：lint/test/build/smoke。如果 CI 默认按变更范围执行，而不是全量执行，单个故障扩散到所有地方的成本会急剧下降。推荐结构：apps/web、apps/admin、packages/config、packages/ui、packages/eslint、packages/tsconfig、packages/utils。为每个文件夹定义清晰的 exports 规则，以防止循环依赖并减少副作用。尽量少共享通用类型。运行示例：bun test --workspaces、bun run build --workspaces、bun run test --workspaces --filter=apps/web、bun run test --workspaces --filter=packages/ui。如果这四行都能正确运行，你就能在发布期间减少超过 70% 的不必要重跑。示例 CI 流水线为 lint -> test -> build -> smoke。如果 build 失败，只对失败的 workspace 进行详细重跑，而不是重跑全部内容，并保留成功范围的日志以便复用。按 workspace 拆分缓存键，并包含 git sha 以防污染。迁移期间不要一次性改动所有内容。第 1 周用于制定规则，第 2-4 周用于范围拆分，第 5-8 周用于 canary 发布，之后通过指标复盘持续改进。即使团队速度连续四周出现波动，也要通过记录推进流程，确保结构本身不发生摇摆。执行洞察：1) 日志不足时，错误会激增。2) 当依赖方向变成循环时，指标会失去意义。3) 如果故障发生后 10 分钟内没有恢复流程，可能会损失一整天。4) 如果所有权未定义，瓶颈会扩散到整个团队。FAQ 1) Bun 1.2 能立即替代 Turborepo 吗？A) 对中小型团队而言可以，只要 CI 规则已经建立；图优化可以后续再扩展。FAQ 2) workspaces: 最大的优势是什么？A) 它强制执行范围化运行，并减少影响半径。FAQ 3) lockfile 冲突怎么办？A) 通过单一 CI 更新路径和 merge templates 来减少冲突。FAQ 4) 发布失败应如何处理？A) 只重跑失败范围，然后执行 smoke testing 和 canary deployment。FAQ 5) 应该跟踪哪些指标？A) 范围失败率、回滚次数、缓存命中率和恢复时间。FAQ 6) 为什么内部链接是必要的？A) 它们能让你通过引用路径追踪策略变更背后的依据，同时提升可搜索性和停留时间。最后，内部链接：/tools/monorepo-guide、/tools/ci-stability、/tools/workspace-template、/tools/release-playbook、/tools/cloudflare-pages-deploy。如果你在实践中保留这份检查清单，下个季度就可以复用同一模板。