micro-app
micro-app（@micro-zoe/micro-app）是京东开源（jd-opensource，前身 micro-zoe）的微前端框架，官方自我定位是「一款简约、高效、功能强大的微前端框架」。它最鲜明的路线，是借鉴 WebComponent 的 CustomElement 思想：用浏览器原生的 window.customElements.define 把整套微前端能力包装成一个 <micro-app> HTML 标签——主应用只要写 micro-app name='x' url='...'/micro-app 这一行标签，就能像用普通 HTML 元素/框架组件一样把子应用嵌进页面，因此它把自己标榜为接入成本全场最低的微前端方案（官方语「只需一行代码，实现微前端，如此简单」「无关技术栈，任何框架皆可使用」）。要澄清的是：它是类 WebComponent（webcomponent-like）——只借用了 CustomElement「自定义标签」这一层，默认并不用 Shadow DOM 做隔离，而是靠样式隔离（scopedcss 前缀改写）+ 元素隔离（DOM 作用域）+ JS 沙箱三件事各自实现隔离。JS 沙箱默认是 with 沙箱（Proxy 拦截 + with 改作用域链，思路近 qiankun 的 proxySandbox 但叠了 with），1.0 起新增 iframe 沙箱作为可选强隔离模式（iframe 属性开启）。此外它自带虚拟路由系统（拦截浏览器路由、给子应用一套隔离的 location/history，5 种 router-mode）、数据通信、预加载、keep-alive 保活、UMD/插件系统等能力，并原生亲和 Vite/ESM。版本上它长期停留在 1.0.0-rc（2021-06 建库、至今 rc.x 持续发版），是「持续活跃但 1.0 长期 RC」的典型。沙箱、CSS 隔离、通信的通论已在微前端核心机制叶讲透，本叶只讲 micro-app 的具体实现与 API。
概述
- 定位：micro-app 是京东开源、类 WebComponent（CustomElement）容器的微前端方案——把微前端封装成
<micro-app>自定义标签，主应用一行标签即可接入，从「组件化思想」使用子应用，接入成本在同类框架里最低。 - CustomElement ≠ Shadow DOM：它用
customElements.define定义<micro-app>标签（这是「类 WebComponent」的含义），但默认不启用 Shadow DOM；隔离靠元素隔离 + scopedcss 样式隔离 + JS 沙箱三者分工，shadowDOM只是可选的样式隔离增强。 - 双沙箱模式：默认 with 沙箱（
Proxy+with造相对独立的window/document，全局变量隔离、性能好、兼容广）；1.0 起提供 iframe 沙箱（iframe属性开启，隔离更强、兼容代价更大），二者按场景取舍。 - 能力齐全：虚拟路由系统（5 种
router-mode、microApp.router编排）、数据通信（data/setData/dispatch/全局数据）、预加载、keep-alive 保活、资源地址补全、UMD/插件系统，且原生友好 Vite/ESM。 - 版本与选型：1.0 长期 RC（当前
1.0.0-rc.32，rc.x 持续发版），京东生态背书、约 6.2k star；甜区是**「要最低接入成本 + 组件化用法 + Vite 主力」**，代价是 1.0 未正式发布的心理门槛、默认软沙箱隔离不及 iframe、主应用样式仍会下渗子应用。
本叶地图
- 入门 —— micro-app 解决什么、最小接入（
<micro-app name url>一行标签）、CustomElement 容器心智、与 qiankun/wujie 的接入成本对比 - CustomElement 容器 —— 借 WebComponent 的 CustomElement 定义
<micro-app>标签、name/url/baseroute等属性、组件化接入、生命周期事件（created/beforemount/mounted/unmount/error） - with 沙箱（默认） —— 默认
Proxy+with沙箱、元素隔离、全局变量隔离、__MICRO_APP_*__环境变量、顶层变量不挂 window 等常见坑 - iframe 沙箱模式 —— 1.0 起可选 iframe 沙箱（
iframe属性）、与 with 沙箱的取舍、iframeSrc/window.stop()初始化坑、何时选 iframe - 元素与样式隔离 —— 元素隔离（DOM 作用域、
removeDomScope）、样式隔离（scopedcss 前缀改写、disableScopecss、shadowDOM）、与主应用样式冲突处理 - 数据通信 ——
data/setData下行、dispatch上行、setGlobalData/getGlobalData全局数据、EventCenterForMicroApp、与虚拟路由的关系 - 1.0 RC 与现状 —— 1.0 长期 RC 时间线（rc.x 持续发版）、京东生态背书、虚拟路由系统、ESM/Vite 友好、选型定位、与 wujie 对比、局限
- 参考 —— 核心属性/API、双沙箱对比、生命周期事件、样式隔离方案、数据通信、版本状态七张表 + 权威链接
文档地址
- micro-app 官网 —— 定位、特性、在线演示总入口
- 快速开始 · 配置项 —— 主/子应用接入、
<micro-app>全部属性与全局配置 - 沙箱 · 数据通信 · 虚拟路由 —— with/iframe 双沙箱、通信 API、
router-mode一手说明 - GitHub: jd-opensource/micro-app · Releases —— 源码与 1.0 RC 版本状态核对源