必须设置 navigationStyle: "custom" 并配合 app-plus.titleNView: false 才能真正移除原生导航栏；plus.navigator.setFullscreen(true) 需在 onShow 中用 #ifdef APP-PLUS 包裹调用，布局应使用 CSS 变量 --status-bar-height 而非 JS 获取值，且须真机安装正式 APK 验证沉浸效果。
navigationStyle: "custom" 是前提，不是可选项
不设这个，后面所有操作都白搭。它不是“美化开关”，而是把原生导航栏控制权交还给前端的硬性条件。只改 navigationbarhidden 或只设 app-plus.titleNView: false 都无效——前者在 App 平台被忽略，后者只关绘制，但页面仍会预留顶部空间。
必须在目标页面的 pages.json 的 style 节点下同时写：
"navigationStyle": "custom""app-plus": { "titleNView": false }
否则部分安卓机型（尤其华为 EMUI、小米 HyperOS、OPPO ColorOS）会在顶部渲染一个不可见的空白 title 区域，造成 20–40px 的顶部留白，内容实际被顶出视口却查不到原因。
plus.navigator.setFullscreen(true) 必须在 onShow 中调用
这个 API 才是真正隐藏状态栏的关键动作，但它有三个硬约束：
- 必须用
#ifdef APP-PLUS包裹，否则 H5 和小程序环境运行时直接报plus is not defined - 必须放在
onShow（或onLaunch），不能放mounted或created——Vue 生命周期早于 plus 环境就绪，调了也静默失败 - 单独调它只隐藏状态栏；若还要隐藏底部虚拟导航栏，得额外加
plus.navigator.hideSystemNavigation()，但注意：该方法在小米 HyperOS、OPPO ColorOS 14+ 等新系统上已失效，属系统限制
用 --status-bar-height 做布局，别信 uni.getSystemInfoSync()
JS 获取的 statusBarHeight 在不同平台返回值极不稳定：iOS 返回真实像素，Android 常固定 24/25，全面屏机型可能不准，H5 和小程序环境甚至不返回。uni-app 在 App 端注入了可靠的 CSS 变量：--status-bar-height。
直接在根容器写：
padding-top: var(--status-bar-height);
如果用了 <uni-nav-bar>，记得显式设 background-color="transparent"，否则默认背景色会挡住状态栏区域。下拉刷新时内容会穿透透明导航栏导致状态栏变黑——此时应临时禁用透明，比如用 :class="{ 'nav-transparent': !isPulling }" 配合 onPullDownRefresh 控制。
真机调试必须用正式打包的 APK
HBuilderX 自带模拟器对 --status-bar-height 渲染不准，也不触发原生窗口 flags 设置，测不出真实沉浸效果。很多“全屏失败”其实是调试阶段误判。截至 2026 年 9 月，华为、小米、OPPO、vivo 主流机型均需通过真机安装正式签名 APK 才能验证最终效果。特别注意横竖屏切换、分屏模式、刘海屏开启等场景下，--status-bar-height 的动态响应是否及时——部分 Android 13+ 设备在启用「刘海区域透明化」后，uni-app 未触发 onresize 回调，需手动监听 plus.screen.onOrientationChanged 补偿。
