# frontend-micro-apps **Repository Path**: mrjinhui/frontend-micro-apps ## Basic Information - **Project Name**: frontend-micro-apps - **Description**: qiankun + npm workspaces monorepo,8 个子应用(Vue2 / Vue3+Vite / React / Svelte),完整覆盖沙箱隔离、跨应用通信、样式污染治理、路由冲突修复等企业级微前端核心命题。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: https://frontend-micro-apps.1163895390.workers.dev/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-13 - **Last Updated**: 2026-10-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 企业级微前端整合样板 > **qiankun + npm workspaces monorepo**,8 个子应用(Vue2 / Vue3+Vite / React / Svelte),完整覆盖沙箱隔离、跨应用通信、样式污染治理、路由冲突修复等企业级微前端核心命题。 --- ## 为什么需要这个项目? 微前端不是"选一个框架装上就完事"——它是一组**工程决策**: - 老项目(Vue2)和新项目(Vue3/React/Svelte)如何共存? - 全局 CSS 怎么互相不干扰?标签选择器穿透 scoped 隔离怎么办? - 子应用路由和基座路由共享 `history` API 导致导航卡死怎么修? - Shadow DOM 隔离下 Vite dev 模式样式丢失怎么补? - 跨应用数据怎么传?Store 怎么共享?事件怎么发? 本项目用 **8 个真实可运行的子应用**回答了以上全部问题,每个坑点都有**可复现的对照实验**和**带注释的修复代码**。 --- ## 架构概览 ``` frontend-micro-apps/ # npm workspaces monorepo ├── apps/ │ ├── portal/ # 基座(主应用) · Vue3 + Vite · :8000 │ │ └── src/micro/ │ │ ├── registry.js # 子应用注册表(唯一事实来源) │ │ ├── setup.js # qiankun 装配(start / registerMicroApps) │ │ └── instances.js # 共享 Store + 事件总线(唯一实例) │ ├── app-vue2-user/ # 用户中心 · Vue2.7 + Vite · :8081 │ ├── app-vue2-order/ # 订单管理 · Vue2.7 + Vite · :8082 │ ├── app-vue3-dashboard/ # 数据看板 · Vue3 + Vite · :8083 │ ├── app-vue3-report/ # 报表中心 · Vue3 + Vite · :8084 │ ├── app-react-mall/ # 积分商城 · React18 + Vite · :8085 │ ├── app-react-cms/ # 内容管理 · React18 + Vite · :8086 │ ├── app-svelte-monitor/ # 监控告警 · Svelte4 + Vite · :8087 │ └── app-svelte-log/ # 日志中心 · Svelte4 + Vite · :8088 ├── packages/ │ └── shared/ # 框架无关共享包 │ ├── store/ # 全局 Store(框架无关,九端同步) │ ├── event-bus/ # 事件总线(发布订阅) │ ├── adapters/ # 四框架适配器(Vue2/Vue3/React/Svelte) │ └── constants/ # Token / 事件名 / 全局状态键 ├── scripts/ │ └── merge-dist.mjs # 合并部署构建脚本(单域名方案 A) ├── deploy/ │ └── _headers # Cloudflare Pages 响应头(缓存策略) ├── .github/workflows/ │ └── deploy.yml # CI/CD:push 自动部署到 Cloudflare Pages └── package.json # workspaces 根配置(npm workspaces) ``` --- ## 8 个子应用一览 | 应用 | 技术栈 | 端口 | 挂载方式 | 沙箱策略 | 演示坑点 | |---|---|---|---|---|---| | 用户中心 | Vue 2.7 + Vite | 8081 | 路由 | scoped | 老项目 `window.LEGACY_GLOBAL` + filters + Options API | | 订单管理 | Vue 2.7 + Vite | 8082 | 路由 | scoped | Vue2 老项目表格 + 全局 mixin | | 数据看板 | Vue 3 + Vite | 8083 | 路由 + Widget | scoped | 双模式路由(history/memory) | | 报表中心 | Vue 3 + Vite + Pinia | 8084 | 路由 + Widget | scoped | 本地 Pinia vs 共享 Store 边界 | | 积分商城 | React 18 + Vite + CSS Modules | 8085 | 路由 | scoped | CSS Modules 编译期隔离 | | 内容管理 | React 18 + Vite | 8086 | 路由 + Widget | **Shadow DOM** | Shadow DOM + Vite 样式同步 | | 监控告警 | Svelte 4 + Vite | 8087 | 路由 + Widget | scoped | 定时器清理(onDestroy) | | 日志中心 | Svelte 4 + Vite | 8088 | 路由 | scoped | 手动订阅退订 + 日志总线消费 | --- ## 核心特性 ### 1. 双轨制样式隔离 | 隔离方式 | 适用应用 | 原理 | 局限 | |---|---|---|---| | `experimentalStyleIsolation` (scoped) | 7 个普通应用 | 给子应用 CSS 选择器加 `div[data-qiankun]` 前缀 | **挡不住全局标签选择器穿透**(`p`/`h1`/`a` + `!important`) | | `strictStyleIsolation` (Shadow DOM) | react-cms | 子应用整体挂载进 Shadow DOM,内外样式完全互不可见 | **Vite dev 模式 CSS 注入到 `document.head`,Shadow DOM 内看不到** | **对照实验**:样式隔离实验室页面(`/app-style-lab`)提供一键注入/移除污染样式按钮,可直观对比两种隔离效果。 ### 2. 三种跨应用通信机制 | 机制 | 原理 | 适用场景 | |---|---|---| | **共享 Store**(机制①) | 框架无关的全局状态对象,通过 qiankun `props` 下发 | 购物车角标、主题、用户信息、消息中心 | | **qiankun GlobalState**(机制②) | `initGlobalState` / `setGlobalState` / `onGlobalStateChange` | 小而关键的双向同步字段(主题、在线数) | | **事件总线**(机制③) | 发布订阅模式,`eventBus.emit` / `eventBus.on` | 一次性通知(`NOTIFY`)、日志写入(`LOG_WRITE`)、购物车同步(`CART_SYNC`) | ### 3. 路由模式分流 | 环境 | Vue3 (vue-router 4) | Vue2 (vue-router 3) | React (react-router 6) | |---|---|---|---| | **qiankun 模式** | `createMemoryHistory()` | `mode: 'abstract'` + 手动 `push('/')` | `` | | standalone 模式 | `createWebHistory('/')` | `mode: 'history'` | `` | **为什么不用 web history?** 两个 router 实例共享 `history.pushState/replaceState` 和 `history.state`,互相覆盖导致 `SecurityError: replaceState` + 基座侧边栏导航间歇性卡死。 ### 4. 双挂载模式 - **路由挂载**(`registerMicroApps`):基座侧边栏切换应用,URL 反映当前应用 - **ID 容器挂载**(`loadMicroApp`):聚合页(`/app-aggregate`)同时展示多个子应用 Widget --- ## 坑点清单(12 条实战经验) 每条坑点在代码中都有**详细注释**和**可复现的修复方案**: | # | 坑点 | 修复方案 | 代码位置 | |---|---|---|---| | 1 | **registerMicroApps 不读应用级 sandbox 字段**(只读 `start()` 全局配置) | 全局 `start({ sandbox })` 给多数应用 scoped 隔离;Shadow DOM 应用用 `loadMicroApp` 手动加载 | `setup.js` + `SubappView.vue` | | 2 | **全局标签选择器穿透 scoped 隔离**(`p { color: red !important }`) | 用 `strictStyleIsolation`(Shadow DOM) 阻断;scoped 只防"泄漏"不防"灌入" | `StyleLabView.vue` 污染对照实验 | | 3 | **Shadow DOM 下 Vite dev 模式样式丢失** | `MutationObserver` 监听 `document.head` 新增 `