Umijs 文档站

UmiJS（中文名“乌米”）是蚂蚁金服开源的企业级前端应用框架，以路由为核心、插件体系贯穿全生命周期，已服务蚂蚁内部3000+应用及阿里、优酷、网易等外部项目。

核心能力与特色

UmiJS 不是单纯的打包工具或脚手架，而是一套从源码到构建产物全覆盖的框架。其设计围绕“路由驱动”和“插件化”展开，内置功能均以插件形式实现，开发者可通过插件和插件集按需组合，实现垂直域分层。

• 完备路由：同时支持配置式路由和约定式路由，覆盖动态路由、嵌套路由、权限路由等场景
• 插件体系：生命周期完善的插件机制，覆盖开发、构建、部署、测试各阶段，内部功能全由插件完成
• 开箱即用：仅需一个依赖即可启动项目，内置路由、构建、部署、测试及React集成插件集，满足日常80%开发需求
• 大量自研：包含微前端、组件打包、文档工具、请求库、hooks库、数据流等周边工具
• 面向未来：持续跟进modern mode、webpack@5、自动化external、bundler less等新技术

适用场景与限制

UmiJS 适合需要统一技术栈、快速搭建企业级应用（中后台、移动端、Hybrid、纯前端资产、CMS等）的团队。但若项目需支持IE8以下浏览器、React 16.8.0以下版本、Node 10以下环境，或有强烈webpack自定义需求，则不建议使用。

快速上手与配置

环境要求Node ≥10.13，推荐使用yarn（国内建议tyarn或ayarn）。通过官方脚手架`yarn create @umijs/umi-app`初始化项目，核心配置集中在`.umirc.ts`或`config/config.ts`中。

• 环境准备：Node ≥10.13，推荐yarn（国内源tyarn或阿里内网ayarn）
• 脚手架：`yarn create @umijs/umi-app`生成项目骨架
• 启动开发：`yarn start`，默认端口8000，支持webpack增量编译
• 构建部署：`yarn build`输出到`./dist`目录，可通过`serve`本地验证
• 配置示例：支持base、publicPath、hash、history模式（hash/browser）、路由配置（含重定向、wrappers拦截）

与同类框架的差异

相比create-react-app（打包层方案，不含路由和框架能力）和next.js（优秀但不够贴近业务），UmiJS更注重企业级业务整合，深度集成antd、dva、国际化、权限、数据流等一线开发者常用功能。

常见问题

Q1：UmiJS 是否支持微前端？

A1：支持。UmiJS 自研了微前端方案，属于其大量自研工具之一，可用于拆分大型应用为独立子应用。

Q2：UmiJS 的插件体系如何工作？

A2：UmiJS 实现了完整的生命周期，内部所有功能均由插件完成。开发者可编写插件或使用插件集（如@umijs-preset-react），覆盖从源码到构建产物的每个阶段，实现功能扩展和垂直域分层。

Q3：UmiJS 与 create-react-app 的主要区别是什么？

A3：create-react-app 是打包层方案，不包含路由和框架能力，不支持配置修改。UmiJS 是完整的企业级框架，提供配置式/约定式路由、插件体系、深度整合antd/dva等，适合需要技术收敛的大型项目。

更多同类工具与网站,可在构建工具分类继续挑选。

信息核实于 2026年7月,具体以官网为准。