真全屏沉浸式状态栏需三步联动：pages.json中目标页设navigationStyle:"custom"且titleNView:false；onShow中调plus.navigator.setFullscreen(true)；CSS用var(--status-bar-height)占位并适配透明导航栏。
uni-app 实现真全屏沉浸式状态栏，只靠 navigationStyle: "custom" 或 uni.setNavigationBarColor 都不行——必须三步联动：配置交权 + 原生 API 隐藏 + CSS 占位适配。缺一不可。
pages.json 必须设 navigationStyle: "custom" 并关掉 titleNView
这不是“美化开关”，而是把顶部控制权从原生容器手里抢回来的唯一方式。不设这个，后面所有操作都静默失效。
- 必须写在目标页面的
style节点下（不能只写在globalStyle），例如：{"path": "pages/video/video", "style": {"navigationStyle": "custom", "app-plus": {"titleNView": false}}} -
"titleNView": false是硬性配套项，尤其 Android 厂商定制系统（如小米 HyperOS、OPPO ColorOS 14+）不加它，会在顶部渲染一个看不见的空白区域，导致内容被顶高 - 别用
navigationBarHidden: true—— 这个在 App 平台完全被忽略
onShow 中调 plus.navigator.setFullscreen(true) 才真正隐藏状态栏
这个 API 是触发原生层全屏的关键动作，但时机和环境稍有偏差就白跑一趟。
- 必须包裹
#ifdef APP-PLUS，否则 H5 和小程序会报plus is not defined - 只能在
onShow或onLaunch中调，mounted/created阶段plus环境还没就绪，调了也不报错、不生效 - 单独调它只隐藏状态栏；想连底部虚拟导航栏一起藏，得额外加
plus.navigator.hideSystemNavigation()，但注意：该方法在 Android 12+ 多数新系统（华为鸿蒙 NEXT、小米 HyperOS）已失效，属系统限制，非代码问题
用 var(--status-bar-height) 做 CSS 占位，别碰 uni.getSystemInfoSync().statusBarHeight
JS 获取的高度在不同平台返回值混乱（iOS 是真实像素，Android 常固定 24/25，全面屏机型不准），且 H5 和小程序里直接是 undefined。uni-app 在 App 端注入的 CSS 变量才是唯一可靠来源。
- 根容器加：
padding-top: var(--status-bar-height);
- 若用
background-color="transparent"，否则默认背景色会挡住状态栏区域 - 开启下拉刷新后内容常穿透透明导航栏变黑？正确做法是临时禁用透明，比如：
:class="{ 'nav-transparent': !isPulling }"，并在onPullDownRefresh和stopPullDownRefresh中切换isPulling状态
真机调试必须用正式打包的 IPA/APK
HBuilderX 自带模拟器对 --status-bar-height 渲染不准，也不触发原生窗口 flags 设置，测不出真实沉浸效果。很多“全屏失败”其实是调试阶段误判——你写的代码可能完全正确，只是没在真设备上验证。
另外，横屏全屏需双保险：manifest.json 的 app-plus → orientation 显式声明方向，且在 App.vue 的 onLaunch 中调 plus.screen.lockOrientation('landscape-primary')；退出时记得用 plus.screen.unlockOrientation() 恢复，否则其他页面也被锁死。
