必须封装弹窗而非直接使用uni.showToast()或uni.showModal()，因跨平台样式与交互不一致；App端需用subNVue实现全局覆盖，H5/小程序宜用透明页面方案，并用Vuex管理队列防重叠。
直接用 uni.showToast() 或 uni.showModal() 无法跨平台保持一致样式和交互逻辑，必须自己封装——但别从零写 DOM 层，优先基于 uni-app 的 subNVue 或「透明页面跳转」方案，否则在 App 端会被导航栏/TabBar 截断，H5 端又容易被滚动穿透。
为什么不能只用普通 view 写弹窗
普通
- 小程序端看似能跑通，但微信/支付宝/百度对
position: fixed支持不一，顶部/底部定位常偏移 - App 端若强行用
plus.nativeObj.View，后续改样式、加动画、响应按钮事件都得写原生桥接，维护成本爆炸 - 最稳的路径是：小程序走自定义组件 + 条件编译，App/H5 走
subNVue或「透明页面」
用 subNVue 实现真正全局覆盖（App 端首选）
subNVue 是 uni-app 提供的原生子窗体能力，能脱离 webview 层级，完美覆盖状态栏、导航栏、tabBar，且支持独立动画和手势控制。
- 必须在每个使用页面的
page.json中显式配置subNVues，不能靠 easycom 自动注入 - 弹窗内容需单独写成
.nvue文件（不是.vue），否则编译报错 - 通过
uni.$emit或 Vuex 触发显示，用subNVue.show()控制显隐，subNVue.hide()关闭 - 注意：iOS 上
subNVue的animationType仅支持fade和pop-in，缩放动画得用transform+animation手写
用透明页面模拟弹窗（小程序 + H5 兼容方案）
新建一个全透明页面 pages/global-popup/global-popup.vue，配置 navigationStyle: "custom" 和 backgroundColor: "transparent"，再用 uni.navigateTo 打开——它本质是页面跳转，但视觉上就是弹窗。
- 页面内用
onLoad接收参数：uni.navigateTo({ url: "/pages/global-popup/global-popup?config=" + encodeURIComponent(JSON.stringify(opts)) }) - 必须在
pages.json中为该页面关闭下拉刷新、禁用滑动返回（"enablePullDownRefresh": false, "disableScroll": true） - 遮罩层要监听
@touchmove.stop.prevent，否则 iOS 微信里会触发页面回弹 - 关闭时统一用
uni.navigateBack({ delta: 1 })，不要用uni.redirectTo，否则路由栈混乱
Vuex 管理弹窗队列与状态（避免多弹重叠）
不用 Vuex 或类似状态管理，多个页面同时调用弹窗就会堆叠、闪退、按钮失效。核心是把 current 和 queue 分离：
-
state.current存当前正在显示的弹窗配置（visible: true时才渲染） -
state.queue存待显示的弹窗数组，每次show()都 push 进去，hide()后自动 shift 下一个 - duration 超时后必须 commit
HIDE_TOAST，不能只靠setTimeout，否则页面卸载时定时器还在跑，内存泄漏 - 在 App 端，
subNVue隐藏后要手动清空current，否则下次 show 会因状态残留失败
最易忽略的是：不同平台对「快速连续弹多次」的处理逻辑完全不同——小程序允许并行，App 的 subNVue 不支持同名重复 show，H5 页面跳转有最小间隔限制。队列机制不是可选项，是必选项。
