百度关于微前端架构 EMP 的探索：落地生产可用的微前端架构

导读：随着 Web 前端工程‬日趋复杂，也‬带来了更大的工程理治‬挑战，微前端在‬大型前端工架程‬构解决方案中成已‬为重要思路之一。本文详细描述 EMP 的诞生背景、使用场景、生态以及如何使用，可以帮助大家能更简单、更高效的构建生产可用微前端架构。

一、EMP 是什么

EMP 是一个微前端架构解决方案集合，旨在帮助大家能更简单、更高效的构建生产可用微前端架构。https://github.com/efoxTeam/emp

2020 年 5 月开始，我们团队开始探索微前端架构。调研从主流的 iframe、Single SPA 到那时刚刚问世的 module federation，最后选择性能和比较有前景的 module federation 作为基础技术进行架构 EMP 微前端解决方案。至今有一年多，已经 releases 53 个版本，解决 108 个 issues，同时具有一定程度生态，有 43 种使用场景的 Demo，支持 7 种 EMP UI 插件支持（包括但不限于 React、Vue、Angular、Preact），4 个编译器支持（babel、esbuild、swc、esm），1 个 Webpack Plugin，目前 EMP 已在服务的线上应用具有一定的稳定性和扩展性。

二、EMP 出现的背景

随着 Web 应用的日渐强大，随之而来的是前端项目不断膨胀。业务需求不断叠加的情况下，巨石项目越来越难维护，编译时间越来越难等。具体来说是，可能会出现 几 MB 的 Bundle Size、十几甚至几十号前端开发人员、一个前端代码库（含 node_modules）会有几 GB。所以需要思考如何把庞大的 Web 项目分解成若干个项目，以便于团队分工协作。

业务开发中，不同项目之间会存在很多可复用的模块。通用的用户数据、UI 架构风格、相似的业务逻辑都可以复用，例如一个时间戳转时间的函数就可以到处复用而无需重写甚至引库。所以需要思考如何可以让多个应用项目直接共享这些可复用的模块。当然拆成 NPM 包是一个不错的想法，也是最常用的。

三、EMP 的优势

• 巨型项目解耦。把巨型项目分解成多个小型项目，分团队开发维护。

• 快速封装可复用模块。无需单独拆包发布到 NPM，可直接暴露需要共享的模块。引入端仅需要简单配置输出端的地址即可在代码上使用该共享模块。

• 动态更新。把复用的业务模块放在同一个基站应用之中进行管理和维护，并且暴露出去可以给多个应用使用。如果业务模块需要更新逻辑的话，只需要发布部署基站应用，其他应用并不需要任何操作，只需要访问时刷新，即可使用最新业务模块。

• 远端模块，由于引入端无需手动更新，远端模块的灵活维护和引入端可以自由组合，甚至可以运行时引入使用远端模块。

• 加速构建。因为引入其他项目暴露的模块，不需要本地构建这些子模块的代码，减小了构建体积，提升整个应用的构建速度。- 减少单个项目 Bundle Size。因为引入其他项目暴露的模块，减少各个项目 Bundle Size。

• 下图时对旧项目改造使用了 EMP 微前端方案后带来的速度提升的实际数据

四、EMP 架构设计

五、EMP 生态

EMP 针对不同的 UI 框架和使用场景都有进行适配和优化。

六、EMP 开箱即用

1.初始化

npx @efox/emp-cli init

• 可以选择以下模板项目进行初始化，推荐试用 React Typescript 模板

• 按提示执行 cd my-emp && yarn && yarn dev 之后，项目将会自动打开在浏览器。

• React 基站：

• React 项目：

• 如果你想预先安装 @efox/emp-cli，可以通过全局安装 npm install -g @efox/emp-cli 或 yarn global add @efox/emp-cli 。

• 建议你卸载该包使用 npm uninstall -g @efox/emp-cli or yarn global remove @efox/emp-cli 确保 npx 使用的 @efox/emp-cli 是最新版本。

2. EMP 唯一的配置文件 emp-config.js ,

以 React 为例，解释配置核心：

/** * @type {import('@efox/emp-cli').EMPConfig} */module.exports = {  webpack() {    return {      devServer: {        /**         * 设置 devServer         */        port: 8002,      },    }  },  async moduleFederation() {    return {      /**      * name: 对外暴露项目名,      */      name: 'demo',      /**      * filename: 对外暴露引用文件名,      */      filename: 'emp.js',      /**      * remotes 远程模块      * remotes: {      * '引用别名': '远程模块项目名@远程模块的emp.js文件地址',      * },      */      remotes: {        '@emp/demo1': 'demo1@http://localhost:8001/emp.js',      },      /**      * exposes 暴露模块      * exposes: {      * '对外暴露的相对路径': '当前项目相对路径',      * },      */      exposes: {        './components/Hello': 'src/components/Hello',        './helper': 'src/helper',      },      /**      * shared 共享的第三方依赖      * shared: ['依赖名'],      */      shared: ['react', 'react-dom'],    }  },}

以 Vue2 为例，解释配置核心：

const withVue2 = require('@efox/emp-vue2')module.exports = withVue2(({config}) => {  const projectName = 'vue2Project'  const port = 8008  config.output.publicPath(`http://localhost:${port}/`)  config.devServer.port(port)  config.plugin('mf').tap(args => {    args[0] = {      ...args[0],      ...{        /**         * name: 对外暴露项目名,         */        name: projectName,        /**        * filename: 对外暴露引用文件名,        */        filename: 'emp.js',        /**         * remotes 远程模块         * remotes: {         * '引用别名': '远程模块项目名@远程模块的emp.js文件地址',         * },         */        remotes: {          '@v2b': 'vue2Base@http://localhost:8009/emp.js',        },        /**        * exposes 暴露模块        * exposes: {        * '对外暴露的相对路径': '当前项目相对路径',        * },        */        exposes: {          './Content': './src/components/Content',        },        /**        * shared 共享的第三方依赖        * shared: ['依赖名'],        */        shared: ['vue/dist/vue.esm.js'],      },    }    return args  })
  config.plugin('html').tap(args => {    args[0] = {      ...args[0],      ...{        title: 'EMP Vue2 Project',      },    }    return args  })})

七、已有项目无痛升级到 EMP 微前端架构

• @vue/cli Vue2 模版升级到微前端 EMP

• React CRA 项目升级到微前端 EMP

八、跨框架调用实现

EMP 不推荐大家跨框架调用，因为这样会增加维护成本和风险。但是我们还是支持：

• Vue3 调用 Vue2 组件

• Vue&React 互相调用

九、对比 NPM 拆包

但是 npm 拆包有一定工作量：

• 需要把可复用模块从业务项目抽离到一个新的 package

• 搭建新的构建配置

• 单独建 repo

• 在原有业务项目重新引用

• 可能会因为封装，需要重新设计 API

但是业务模块抽离成 npm 包后,使用 npm 包的更新流程繁琐复杂：

• 更新 npm 包版本

• 更新 A 应用的 npm 包版本

• 重启 A 应用进行验证

• 发布部署 A 管理系统应用

• 对 B 和 C 应用循环 2 和 3、4 步骤

但是 npm 包会拖慢构建速度：通过 npm 引入 n 个的业务模块后，在构建时相当于将 n 个业务模块的代码“复制”到了项目中，构建时需要同步去构建这些业务子模块，导致 bundle size 变大，构建时长会增加，开发体验变差，发布效率也会随之降低。

十、总结

• 本文用较短的篇幅介绍了 EMP 的诞生背景、使用场景、生态以及如何无痛使用。

• EMP 在不断迭代升级，同时生态日渐完善，欢迎各位来了解、使用 EMP 微前端解决方案。

• 期待大家一起探讨，欢迎来提 issue 或者新功能：https://github.com/efoxTeam/emp

十一、QA

如果有问题的话，可以先来看看我们的 issue 哦。世界这么大，说不定你和别人遇到一样的问题：https://github.com/efoxTeam/emp/issues?q=is%3Aissue+is%3Aclosed

文章看完，还不过瘾？

更多精彩内容欢迎关注百度开发者中心公众号