uni-app App端原生弹窗必须用subNVue或原生插件实现，因uni.showToast等API基于WebView层，无法穿透web-view/video等系统级原生控件；subNVue是轻量可靠方案，需pages.json配置并真机运行；Ba-Toast插件支持多平台穿透，需manifest启用并注意权限与调用方式。
uni-app 在 App 端调用原生弹窗，不能直接依赖 uni.showToast、uni.showModal 这类 API——它们在遇到 web-view、video、ad、原生插件界面时大概率被遮挡，甚至完全不可见。真正能穿透所有层级的，必须是基于原生子窗体（subNVue）或原生插件（Android/iOS/HarmonyOS）实现的方案。
为什么 uni.showToast 会被遮挡？
因为 uni.showToast 是基于 WebView 层渲染的浮层，而 web-view、video、广告组件、地图、摄像头等都是系统级原生控件，Z-index 无法越级覆盖。这不是 CSS 能解决的问题，是平台渲染层级的硬限制。
- 安卓上：WebView 的 Toast 默认在 Activity 的 DecorView 下，但插件/全屏原生页可能新建了 Window 或 Dialog，Toast 就“掉层”了
- iOS 上：
UIAlertController或UIView动画浮层若未挂载到 keyWindow 最顶层，也会被WKWebView或AVPlayerLayer遮盖 - 鸿蒙上：
AbilitySlice或Window独立生命周期下，JS 层触发的 Toast 若没走UIExtension或PopupWindow机制，同样失效
subNVue 是最轻量可靠的穿透方案
subNVue 是 DCloud 提供的原生子窗体能力，本质是独立于当前页面的原生窗口，可自由控制层级、动画、显示时机，天然支持穿透 web-view/video/插件界面。
- 必须在
pages.json中为对应页面配置"subNVue": [...]，且每个 subNVue 文件需单独存放在subNVue/xxx.nvue目录下 - 不能在 HBuilderX 模拟器调试，只支持真机运行；调试前请确认 manifest.json > app-plus > nvueStyleCompiler 设为
"uni-app" - 显示时用
subNVue.show('slide-in-bottom', 300)，隐藏用subNVue.hide()，不推荐用v-if控制显隐 - 样式写法与普通 nvue 一致，但不支持
%单位和部分 flex 缩写（如flex: 1要写成flex: 1 1 auto）
Ba-Toast 这类原生插件怎么接入？
Ba-Toast 是目前社区验证最稳的穿透型 Toast 插件，封装了各平台原生 Toast 最高权限调用逻辑（Android 用 SystemAlertWindow 权限，iOS 用 keyWindow 强制插入，鸿蒙用 Dialog + WindowManager），调用方式几乎和 uni.showToast 一致。
- 从插件市场安装后，在
manifest.json> app-plus > modules 中勾选启用，并确保 Android 添加了android.permission.SYSTEM_ALERT_WINDOW - 调用时不要写
uni.showToast(...)，而是uni.showToast({ plugin: 'Ba-Toast', ... })（注意：部分旧版需先require或通过uni.requireNativePlugin获取实例） - 鸿蒙 Next（API 12+）需确认插件已适配
ets，否则会报undefined is not an object (evaluating 'plugin.show') - 图标资源需提前打包进插件 assets，不能动态传网络地址；
duration为 0 表示常驻，但鸿蒙端建议设为 3000–5000，避免系统自动回收
自定义原生弹窗插件开发的关键卡点
如果你需要定制化更强的弹窗（比如带输入框、进度条、多按钮联动），绕不开原生插件开发。但这里有几个极易忽略的细节：
- iOS 插件中，
show方法必须在主线程执行：dispatch_async(dispatch_get_main_queue(), ^{...})，否则 UI 不显示 - 安卓插件若用
Toast.makeText，它默认不穿透；必须用WindowManager添加TYPE_APPLICATION_OVERLAY类型 View（Android 8.0+ 需动态申请权限） - 鸿蒙插件里，
Dialog必须通过getTopAbility().getUITaskDispatcher()获取 dispatcher，不能直接 new - 所有平台都禁止在插件回调中直接操作 Vue 实例（如
this.xxx = yyy），应通过success/fail回调通知 JS 层
穿透问题的本质不是“怎么弹”，而是“在哪一层弹”。web 层弹窗永远受限于 WebView 容器，只有脱离容器、挂载到系统 Window 层级的方案才可靠。subNVue 和原生插件不是备选，是必选项——尤其当你的页面里有 video、web-view、地图或第三方 SDK 原生界面时。
