大家好，我是若川。持续组织了近一年的源码共读活动，感兴趣的可以点此加我微信ruochuan12 参与，每周大家一起学习200行左右的源码，共同进步。同时极力推荐订阅我写的《学习源码整体架构系列》包含20余篇源码文章。历史面试系列。另外：目前建有`江西|湖南|湖北`籍前端群，可加我微信进群。

Umi 4 现在可以在 npm 上使用了！详见：umijs.org。

距离上一篇文章和大家介绍 Umi 4 RC 的发布已过去 5 个月，这段时间我们基本都保持了一周一个 RC 的节奏，目前是 RC.24。同时基于 Umi 4 的蚂蚁内网框架也已在 2 个月前发布，目前上线近 100 应用，Umi 4 的主体功能已非常稳定，这也是第一次我们先在内网发布后在社区正式发布。

Umi 4 有什么新功能？

相比 Umi 2 到 Umi 3，Umi 4 有着更宏大的目标，开发时间也长了很多，同时带来的变化是巨大的。

多构建引擎。 Umi 4 同时支持 Vite 和 Webpack 两种构建方式，并尽量确保他们之间功能的一致性，让开发者可以通过一行配置进行切换。可能有些同学会喜欢 dev 用 vite，build 用 webpack 这样的组合。同时我们也在探索包括 ESMi 在内的其他构建方案的探索。

export default {vite: {}
}

默认快。 默认快是多维度的，我们通过 MFSU V3 + Webpack 5 缓存解 Dev 时编译慢的问题；内网还有通过 Webpack 5 物理缓存和 CD 平台结合解 Build 时编译慢的问题；有使用 esbuild 做 js 和 css 的压缩器、配置和 MOCK 文件的读取、jest 的 transformer，让除构建之外的其他环节也飞快；此外还有运行时速度也有考虑。

MFSU V3。 Umi 3 的 MFSU 大家可能多少有接触过，虽然有用，但 DX 不够好。用的时候会遇到一些坑，以至于很多同学都掌握了一项特殊技能，遇到问题时 rm -rf src/.umi。大家可能会遇到 monorepo 不支持、热更新导致 Tab 卡死、请求多导致页面打开慢、一些语法不支持的问题。以上问题在 MFSU V3 中全解！基于此，我们非常有信心地在 Umi 4 中默认开启 MFSU 功能。当然，如果你不喜欢，会保留手动配置 mfsu: false 关闭的口子。同时，MFSU V3 还可脱离 Umi 独立使用。

Umi Max。 这是内部 Bigfish 框架的对外版本，解我们自己的问题，同时也给社区另一个集中化框架的选择，定位是中后台框架，包含了中后台相关的大量最佳实践的插件。如果有定制需求，大家可以参考他来实现内网框架的定制，比如快手团队就有基于 Umi 4 的框架定制，还有 Alita 也是基于 Umi 定制的面向移动端的框架。

$ npm i @umijs/max -D

React Router 6。 我们升级了路由方案到 React Router 6，喜忧参半。好消息是，React Router 6 是 Remix 的基础库，面向框架层做了很多优化，路由实现层更优雅，Umi 得以删除大量路由渲染的代码；坏消息是，带来不少 Break Change，比如之前父路由渲染子路由用 children，得换成。

- { props.children }
+ <Outlet />

支持 Vue。 Umi 4 中提供了 Vue 支持，记得我在 Umi 2 时画过一张架构图，其中就有 Vue 的一环，Umi 3 时也有过尝试，但那会 Vue 3 还不太成熟，接入时遇到不少坑，这个坑今天总算是补上了。此功能由社区同学操刀，只需装载一个 preset 即可切换到 Vue。

export default {presets: ['@umijs/preset-vue'],
};

默认最快的 CSR 请求。 项目构建快解的是 DX 问题，但同时也应该关注 UX。Client Loader 的目的是让应用加载默认快，避免 React 项目经典的 Render-Then-Fetch 的加载瀑布流问题。效果见下图，示例项目的从 9s 降到 6s，这 6s 还是之前截的图，上了 Preload 功能之后其实已更快。

export default function() {// 使用请求数据useClientLoaderData()
}
// 声明请求
export function clientLoader() {}

白盒稳定的 Lint。 Umi 4 里内置了我们精挑细选的 lint 规则，只有质量类不开可能会导致项目问题的规则，不包含风格类的规则，不包含 TypeScript 中 type-aware 类的规则，这类规则需要跑整个项目，会导致性能问题；同时，我们通过 @rushstack/eslint-pach 的方式锁定了 config 里找 plugin 的规则，确保规则是长期稳定的。

SSR。 Umi 4 重写了 SSR 功能，目前此功能还在 beta 阶段，请勿将其用于生产环境。Umi 4 的 SSR 有以下特点，1）server 代码的构建基于 esbuild，所以极快，2）请求的处理类似 next.js 的 getServerSideProps 和 remix 的 loader，只在服务端跑，3）基于 react 18 的 suspense 和 renderToPipeableStream。实现原因，部署层目前仅实现了 vercel 的 adapter。这里有个简单的 Todos 示例：https://test-vercel-chencheng.vercel.app/

export default {ssr: { platform: 'vercel' }
}

API 路由。 Umi 4 约定 src/api 目录下存放的 Serverless Function 格式的文件即为 API 路由。这部分路由会打包成不同平台支持的 Serverless Function 产物。场景比如带 token 的 API 调用、动态数据源、基于 Notion API 的 Blog、Hackernews Clone 等等。基于此，Umi 能做的事的边界就大了很多。不再只是写写中后台，实现静态页面。

export default {apiRoute: {},
}

微生成器。 此概念来自 Modern.js。Modern.js 引入很多新概念，其中「微生成器」还是非常贴切的。他包含两个功能，1）小型脚手架，2）功能的开启与关闭。Umi 3 虽然也有 generate 命令，但只包含功能 1。Umi 4 拓展了下 generate（alias 为 g）命令。除了支持更多类型的小型脚手架生成，还支持功能的开启与关闭，以及比如 Monorepo、react 和 antd 版本等的功能切换。

$ npx umi g
? Pick generator type › - Use arrow-keys. Return to submit.
❯   创建页面 -- Create a umi page by page name创建组件 -- .创建 mock 代码 -- .创建 model 代码 -- .启用 Prettier -- Setup Prettier Configurations启用 Jest -- Setup Jest Configuration启用 E2E 测试 -- .启用 Tailwind CSS -- Setup Tailwind CSS configuration启用 SSR -- .启用 Low Import 研发模式 -- .启用权限方案 -- .启用 Monaco 编辑器 -- .关闭 Dva 数据流 -- Configuration, Dependencies, and Model Files for Dva关闭 MFSU -- .切换为 Monorepo 项目 -- .切换 React 为 18 -- .切换 Antd 为 5 -- .

除此之外，我们还有非常多小而美的 DX 改进。

自动 https。 Umi 4 的 https dev server 的实现基于 mkcert，启动过程中会基于 hosts 自动生成对应的 key 和 cert。开发者除了安装前置的 mkcert，其他无需关心。

浏览器里的构建进度条。 如果首次构建没有完成就在浏览器里打开，你会看到一个构建进度条，支持 webpack 多实例，支持 MFSU，完成初始构建后会自动跳转到项目页。

Terminal 中的日志。 有些开发者会更希望在命令行里看到项目里通过 console 输出的日志，比如我。因为命令行日志不会随着刷新而失效，大家可能都经历过一些一闪而过的页面，想截屏都难；同时命令行日志还可以做物理存储，导出后可以方便他人排查。此功能复刻自 https://github.com/patak-dev/vite-plugin-terminal。

import { terminal } from 'umi';
terminal.log(`Some info from the app`);

然后就可以在命令行中看到日志，

umi.js 产物调试。 不知大家是否会有这样的需求，开发项目时发现一些比较复杂的问题时，需要调整构建产物的代码。而 Bigfish 基于 webpack-dev-server，在 dev 阶段所有文件都存于内存中，没有物理文件的形式，并不方便直接修改后验证效果。如果大家用 Umi 4，可以把 umi.js 等产物文件保存到项目根目录，然后可以直接修改即生效。

项目级插件：plugin.ts。 为进一步降低项目中使用插件的门槛，Bigfish 4 中约定项目根目录下的 plugin.ts 为插件，开发者可在此直接调用插件 API，无需注册，支持 TypeScript。有了这个文件，我们可以在项目级做很多事。比如，

import { IApi } from 'umi';
export default (api: IApi) => {// 比如修改 HTMLapi.modifyHTML($ => {return $;});// 比如在入口的 umi.ts 中添加代码api.addEntryCodeAhead(() => [`console.log('entry code ahead')`]);api.addEntryCode(() => [`console.log('entry code')`]);// 比如在构建完成时做额外的事api.onBuildComplete((opts) => {});// 比如在启动阶段做额外的事api.onStart((opts) => {});// 比如校验每个 JavaScript/TypeScript 代码api.onCheckCode((args) => {});// 比如动态修改路由api.modifyRoutes((routes) => {});
}

deadCode 检测。 项目中通常会有未使用的文件或导出，Umi 4 中通过配置 deadCode: {} 即可在 build 阶段做检测。如有发现，会有类似信息抛出。

Warning: There are 3 unused files:1. /mock/a.ts2. /mock/b.ts3. /pages/index.module.lessPlease be careful if you want to remove them (¬º-°)¬.

Umi UI 卷土重来？ 日常排查问题时，很多 Umi 框架的内部状态是看不到的，比如插件启用情况、appData 元数据、修改过的最终配置、修改过的最终 webpack 配置、修改过的最终路由、MFSU 的 module graph 信息等。Umi 4 提供了 /__umi/ 路由，dev 阶段可用，效果见下图。定位是开发辅助，大家也可以理解为是「丐版 Umi UI」。

我可以做什么？

Umi 4 发布之后，我可以做什么？

① 升级项目到 Umi 4
② 使用 Umi 4 开启新项目
③ 参与贡献
④ 订阅 NewsLetter
⑤ 交流反馈群

Ant Design Pro 已完成到 Umi 4 的升级，不日将发布新版本。

除了使用 Umi，也非常欢迎大家参与贡献 Umi。你的贡献会直接影响到蚂蚁 10000+ 应用和 3000+ 开发者，以及非常多社区的项目和同学。感兴趣的同学可认领入门任务，1 个 PR 即可加入 Umi Contributor 群，和来自五湖四海的朋友们畅聊前沿技术。

我们新增了 NewsLetter 服务，如果大家希望即时了解 Umi 的最新进展，可在新官网 umijs.org 右下角进行订阅。

交流反馈群详见「feedback.umijs.org」。

下一步？

Umi 4 发布后，Umi 团队今年还会在以下方向发力。

① 2022 版的最佳实践
② MFSU V4：更快的 MFSU
③ Father 4 和 dumi 2：新一代组件研发方案
④ ESMi：面向未来的 Bundless 构建方案
⑤ DX（开发体验）和速度

技术方向有迭代才会更有生命力，今年最佳实践会出一个新的版本，包含现有方案的改进，以及新的 monorepo、icon、请求、数据流等方向的最佳实践；MFSU V4 已有思路，会在现有基础上进一步提升其稳定性和速度；Father 4 和 Dumi 2 是新一代的组件研发方案；面向未来的 ESMi Bundless 方案的性能问题已有曙光，预计也会在今年和大家见面；最后，DX 和速度（包括编译时和运行时）是 Umi 一直会关注的点。

················· 若川简介 ·················

你好，我是若川，毕业于江西高校。现在是一名前端开发“工程师”。写有《学习源码整体架构系列》20余篇，在知乎、掘金收获超百万阅读。
从2014年起，每年都会写一篇年度总结，已经坚持写了8年，点击查看年度总结。
同时，最近组织了源码共读活动，帮助4000+前端人学会看源码。公众号愿景：帮助5年内前端人走向前列。