不能直接共享 Pinia 或 Vuex 实例，因 iframe 间 JS 上下文隔离、响应式对象不可序列化且受同源策略限制；需通过 postMessage 实现状态同步，主页面作为仲裁者统一管理状态变更与广播。
不能直接共享 Pinia 或 Vuex 实例——因为每个 iframe 是独立的 JS 执行上下文，createPinia() 在各自 iframe 中调用会生成完全隔离的实例，内存不互通，响应式链路也断开。
为什么 iframe 间无法直接复用 Pinia 实例
浏览器对 iframe 实施严格的同源/沙箱隔离策略：window.parent 和 window.frames[i] 之间只能通过 postMessage 通信；任何试图把 store 实例挂到 window 上、或跨 iframe 直接引用对象的行为，都会失败或被拦截（尤其在 qiankun 等微前端框架中更严格）。
- 即使主页面和子 iframe 同源，
pinia实例本身是闭包 + Proxy 构建的响应式对象，无法序列化传输 -
localStorage可读写，但不触发响应式更新；useStore()在各 iframe 内仍会创建新实例，只是初始 state 从本地存储恢复 - 直接
import同一个 store 模块没用——每个 iframe 的模块加载器（如 vite / webpack）都运行在独立全局作用域下
用 postMessage + 全局事件总线模拟“跨 iframe 状态同步”
核心思路：不共享实例，只同步变更意图。主 iframe（通常是顶层页面）作为状态仲裁者，接收各子 iframe 的状态修改请求，执行后广播变更给所有监听者。
- 定义统一消息协议，例如：
{ type: 'SET_USER', payload: { name: 'Alice' } }或{ type: 'GET_STATE', id: 'user' } - 主页面监听
message事件，维护一份中心 state（可用ref或reactive），收到变更后调用postMessage广播给所有已知 iframe - 每个子 iframe 初始化时向主页面注册自己，并监听来自主页面的
message，收到后更新本地 Pinia store（注意：不是覆盖整个 store，而是按字段 patch） - 避免循环同步：子 iframe 发送变更 → 主页面处理 → 广播 → 子 iframe 收到后跳过自身发起的变更（可加
sourceId字段区分）
示例（主页面逻辑）：
立即学习“前端免费学习笔记（深入）”；
审查 Vue 管理后台的变更请求（Vue 2 + Element UI，Vue 3 + Element Plus）。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
// 主页面：维护中心状态 & 转发
const centerState = reactive({ user: null, theme: 'light' })
const iframes = new Set()
window.addEventListener('message', (e) => {
if (e.source === window || !e.data?.type) return
const { type, payload } = e.data
if (type === 'REGISTER') {
iframes.add(e.source)
} else if (type === 'SET_USER') {
centerState.user = payload
// 广播给所有 iframe（除发送者）
iframes.forEach(iframe => iframe !== e.source && iframe.postMessage({ type: 'SYNC', payload: { user: centerState.user } }, '*'))
}
})
子 iframe 如何接入这套机制并保持响应式
子 iframe 不应自行管理“全局状态”，而是把 Pinia 当作本地缓存层：只读取、只响应广播，所有写操作必须走 postMessage 上报主页面。
- 在子 iframe 的
main.ts或入口逻辑中，调用window.parent.postMessage({ type: 'REGISTER' }, '*')注册自己 - 使用
onMounted监听message，匹配SYNC类型后调用useUserStore().updateFromParent(payload) - 封装一个
useIframeStore()组合式函数，内部自动处理注册、监听、转发逻辑，避免每个 store 都重复写postMessage - 关键点：Pinia 的
state必须设为可写（不要用readonly），且actions中禁止直接赋值，全部委托给主页面
示例（子 iframe 中）：
// 子 iframe：只响应，不决策
const userStore = useUserStore()
window.addEventListener('message', (e) => {
if (e.data?.type === 'SYNC' && e.data.payload?.user) {
userStore.$patch({ user: e.data.payload.user }) // 触发响应式更新
}
})
// 修改用户需上报主页面
const updateUser = () => {
window.parent.postMessage({ type: 'SET_USER', payload: { name: 'Bob' } }, '*')
}
layui 页面里实际落地要注意的坑
layui 常用 layer.open({ type: 2 }) 打开 iframe 弹窗，这类 iframe 默认没有 name 属性，导致 postMessage 的 targetOrigin 难以精确控制；同时 layui 的 iframe 加载时机与 Vue 应用启动不同步，容易出现监听未就绪就发消息的问题。
- 务必在
layer.open的success回调里，等 iframe 的contentWindow可访问后再注册（iframe.contentWindow.postMessage(...)） - 避免用
'*'作为targetOrigin，生产环境应校验e.origin，防止 XSS - layui 的 tab 页签切换可能销毁/重建 iframe，需在
destroy前清理message监听器，否则引发内存泄漏 - 如果子 iframe 使用了
srcdoc或非同源地址，postMessage仍可工作，但无法读取contentWindow，此时只能依赖主页面主动轮询或事件驱动
真正难的不是怎么传数据，而是谁有权限改、改完通知谁、通知后要不要再反馈——这些规则必须在主页面统一裁决，不能交给任意 iframe 自行决定。
