去年 Q3,我们内部平台的前端代码量到了一个临界点。单仓库单应用,70 多个路由页面,超过 10 万行业务代码,一次发版全量构建要 8 分钟,改一行公共组件也要走完整发布流程。团队三个小组挤在一个仓库里,merge 冲突频繁到已经影响日常迭代。摆在桌面上的方案有两类:一类是 qiankun 这种运行时沙箱微前端,一类是 Webpack Module Federation 这种模块级共享方案。最后我们选了 Module Federation,顺手把仓库改造成 pnpm Monorepo,再往上搭了一套物料化低代码平台。
这篇文章不是官方文档的复述,是项目落地之后回头写的一份复盘。重点讲选型时没写在文档里的权衡、大仓边界怎么切、物料注册机制怎么设计、运行时动态加载链路,还有几个让我排查到凌晨的坑。适合准备做微前端拆分、准备搭低代码平台,或者正在纠结要不要上 Monorepo 的团队参考。
先说结论:这套架构最后跑通了。主应用承载壳和基础布局,三个业务子应用独立开发独立部署,物料库让运营能拖拽生成配置页,整体构建时间从 8 分钟降到 1 分半。
1. 从单体巨石到微前端:一次选型复盘
1.1 当时的痛点:一次发布要牵动所有页面
单体应用的痛点,网上已经写烂了,但真正踩过才知道那根刺扎在什么地方。我们当时的问题不是构建慢这么简单,而是三个小组的业务逻辑高度耦合在一个代码库里。运营后台的代码会依赖数据看板的公共组件,数据看板又反过来引入运营后台的工具函数,时间一长,谁也不敢动公共层,因为一改就是十几处连锁改动。
更尴尬的是,我们想引入 Vue 3 做一部分新页面。单体 React 应用内部插 Vue 不是不行,但要同时维护两套构建配置、两套路由、两套状态管理,单页应用的路由切换还容易互相踩全局事件。这个诉求直接推着我们往微前端方向走——不是纯拆业务,而是要把"不同技术栈的区域"从物理上隔开。
当时梳理下来的核心诉求有三个:
- 业务子应用能独立开发、独立部署,发布某个模块不能牵连全局。
- 公共依赖(React、React Router、axios)在运行时尽量只加载一份,不要每个子应用都带着一个 React 上街。
- 新老技术栈可以共存,后续新模块可以用 Vue 3 或更激进的框架,不需要先做技术债迁移。
1.2 为什么放弃 qiankun 而选了 Module Federation
这个选择网上争论很多。qiankun 的沙箱机制成熟,JS 沙箱、样式隔离、loadApp 生命周期管理都做得比较完整,接入时对子应用的构建工具也不挑剔。但我们实测后发现,qiankun 的接入模型对这个场景太重了。
qiankun 要求子应用必须暴露 bootstrap/mount/unmount 生命周期,主应用通过 import-html-entry 机制把子应用的 HTML 拉下来解析执行。这个链路本身没问题,问题是我们要拆的不只是"应用",还有"物料"。物料化低代码平台的核心是:一个远程组件,通过一段配置就能被运行时动态加载并渲染。qiankun 的模式是"注册一个应用",而我们需要的是"注册一堆可组合的模块",这两种粒度对不上。
Module Federation 的模型正好反过来了。它把远程模块当成一个普通的 webpack chunk,通过 exposes/remotes 声明谁提供什么、谁消费什么。远程组件和本地组件在打包时走同一套依赖图,TypeScript 类型、HMR、tree-shaking 全部贯通。低代码平台里的每一个物料,本质上就是一个远程模块,用 MF 来描述物料注册关系,不需要额外造一套加载协议。
下面这个表是我们当时做选型对比留下的记录:
| 对比维度 | qiankun | Module Federation |
|---|---|---|
| 隔离模型 | 运行时 JS 沙箱 + CSS 沙箱 | 模块作用域天然隔离,全局污染靠约定 |
| 接入成本 | 必须改子应用生命周期 | 只需配置 exposes/remotes |
| 公共依赖共享 | 靠 external + 手动托管 | shared 字段自动分片 |
| 远程粒度 | 应用级 | 模块级,可精确到组件/工具库 |
| 构建工具要求 | 不挑 | 需要 webpack 5 或支持 MF 的构建插件 |
| 低代码物料适配 | 需要封装一层协议 | 天然契合远程模块模型 |
当然 qiankun 也有 MF 比不上的地方。qiankun 的沙箱能拦截 document 访问和全局变量写入,MF 做不到这种级别的安全隔离。所以如果你们有硬性的第三方代码隔离要求,qiankun 仍然值得考虑。我们这里没有这种诉求,所有子应用都是自家团队维护,信任边界足够,MF 的"轻隔离 + 强共享"反而更实用。
1.3 技术验证阶段做过的三个最小 Demo
选型不能光靠脑补。我花了一个周末做了三个最小 Demo,基本摸清了 MF 的能力边界。
第一个 Demo 是 host 加载 remote 组件。主应用用 React 18,子应用也暴露一个 React 组件,通过 shared.react 配置验证两个应用是否只加载一份 React。这个 Demo 跑通后,我就放心了大半,因为公共依赖共享是 MF 最核心的价值。
第二个 Demo 是跨框架加载。我把一个 Vue 3 组件暴露成远程模块,主应用里用 React 的 React.createElement 包一层去渲染它。Vue 3 和 React 18 的实例互不干扰,但需要手动做生命周期对接。这个 Demo 直接决定了后续数据看板子应用可以用 Vue 3 开发。
第三个 Demo 和低代码平台相关。我把一个表单组件从应用里拆出来,做成远程物料,再通过一段 JSON schema 动态加载渲染。这个链路跑通之后,物料化的技术路线就确定了:物料 = MF 的 exposed 模块 + schema 描述。
这三个 Demo 花了大概一天半,换来的是整个架构方向的确定性。我一直觉得,微前端这种涉及全团队协作模式的技术改造,前期多花时间做验证 Demo,比后期在错误方向上修补要划算得多。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Monorepo 大仓:子应用边界如何切才不后悔
2.1 apps 与 packages 的划分逻辑
微前端解决了部署和运行时隔离的问题,但如果代码还堆在一个巨型仓库里,团队协作的摩擦并不会自动消失。所以我们在上 MF 的同时,把仓库改造成了 pnpm Monorepo。这一步当时有争议,有同事觉得"微前端 + Monorepo"是双重复杂度,可能得不偿失。现在回头看,两个一起上反而是对的——MF 负责运行时解耦,Monorepo 负责源码层共享,它们解决的问题正好互补。
大仓目录结构是这样的:
text复制apps/
main-app/ # 主应用,MF host
admin-app/ # 运营后台子应用,MF remote
dashboard-app/ # 数据看板子应用(Vue 3),MF remote
builder-app/ # 页面搭建器子应用,MF remote
packages/
shared/ # 共享 tsconfig、ESLint 配置、通用工具函数
design-system/ # 基础组件库
material-schema/ # 物料描述类型与校验规则
material-registry/ # 物料注册表,维护物料元信息
http-client/ # 统一请求封装
runtime-store/ # 跨应用共享的全局状态包
边界划分就一条铁律:会不会作为独立入口部署? 会,就放 apps/;只是被其他应用引用,就放 packages/。builder-app 虽然本质是低代码平台的一部分,但它有独立的部署入口和独立的路由,所以它必
