微前端样式隔离需三重保障：一是组件库加命名空间前缀（如ep-button），二是PostCSS自动选择器前缀+动态注入CSS，三是子应用必须挂载到closed Shadow DOM并重置继承链。

Element Plus / Ant Design 等 UI 库必须改命名空间

直接复用默认类名（如 el-button、ant-btn）是微前端样式污染的高发源头——两个子应用都引入同一套组件库，后加载的 CSS 会覆盖先加载的，且沙箱完全不拦截这类静态类名规则。

• Vue 项目：在 main.ts 初始化时传入 { namespace: 'ep' }（Element Plus）或 { prefixCls: 'my-ant' }（Ant Design Vue），让所有组件生成带前缀的 class
• SCSS 变量同步改写：新建 element-namespace.scss，用 @forward 'element-plus/theme-chalk/src/mixins/config.scss' with ($namespace: 'ep') 覆盖变量，再通过 vite.config.ts 的 css.preprocessorOptions.scss.additionalData 全局注入
• 检查构建产物：确认 .ep-button、.my-ant-btn 类名真实出现在 HTML 和 CSS 中，而非仍为原始类名

Vite 子应用不能依赖 experimentalStyleIsolation

qiankun 的 experimentalStyleIsolation 对 Vite 构建的子应用基本无效——Vite 的 CSS 注入走的是 import 'xxx.css' → style 标签插入 head 的路径，qiankun 劫持不到这个过程，样式照样进全局。

• 必须用 postcss-prefix-selector 插件：在子应用的 postcss.config.js 中配置，指定前缀如 .subapp-order，自动重写所有选择器（.btn → .subapp-order .btn）
• 禁用 link[rel="stylesheet"]：子应用构建时移除所有 <link href="xxx.css">，改用 JS 动态加载并注入到自身容器内（如 container.appendChild(styleEl)）
• 验证方式：打开 DevTools，搜索 .subapp-order，确认所有子应用样式规则都带该前缀，且无裸露的 .btn 规则

Shadow DOM 是唯一能切断层叠链的原生方案

浏览器对同一 document 内所有 CSS 统一计算优先级，scoped、modules、prefix 都只是“降低冲突概率”，只有 Shadow DOM 能真正隔离作用域——它的样式表不参与主文档的层叠计算。

PigX UI 前端开发

PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。

下载

• 必须用 mode: 'closed'： attachShadow({ mode: 'closed' }) 才能阻止外部脚本访问 shadowRoot，open 模式等于没隔离
• 子应用渲染目标必须是 shadowRoot：React 用 createRoot(shadowRoot).render()，Vue 用 createApp(App).mount(shadowRoot)，绝不能挂载到 document.body
• 动态样式注入要手动：不能靠 <link rel="stylesheet"> 直接扔进 shadowRoot，需用 const style = document.createElement('style') + style.textContent = cssText + shadowRoot.appendChild(style)

主应用必须主动切断继承链

即使子应用样式被隔离，主应用的 font-family、color、line-height 等仍会通过继承透传过去，导致子应用文字发虚、行高错乱等“隐形污染”。

立即学习“前端免费学习笔记（深入）”；

• 在主应用容器上加 all: initial：比如给子应用挂载节点 <div id="subapp-order" style="all: initial">，重置所有可继承属性 <li>显式重设基础值：紧随 <code>all: initial 后，用 font-family: system-ui、color: #333 等恢复必要样式，避免子应用彻底失焦
• 禁止子应用定义全局 CSS 变量：约定所有 --primary-color 等由主应用统一提供，通过 shared 或主题上下文下发，子应用只消费不声明
真正的难点不在技术选型，而在于所有团队必须同步遵守命名空间、禁用全局样式、渲染目标约束这三条铁律——漏一条，隔离就失效。