UniApp真全屏需三步：pages.json设navigationStyle:"custom"并关闭titleNView；onShow中调plus.navigator.setFullscreen(true)隐藏状态栏，必要时加hideSystemNavigation()；横屏需manifest声明方向+onLaunch锁定。
UniApp 实现真全屏（隐藏状态栏 + 隐藏系统导航栏）在 App 端必须分三步走：改配置、锁方向、调 API。只设 navigationStyle: "custom" 或只写 navigationBarHidden: true 都无效——前者只隐藏原生导航栏但留着状态栏，后者在 APP 平台压根被忽略[^5]。
pages.json 中 navigationStyle 必须设为 custom
这是所有自定义顶部行为的前提，不是可选项。APP 端的原生导航栏由容器控制，不设 custom 就永远无法交出控制权：
-
navigationStyle: "default"：显示系统默认导航栏（带标题、返回键），setFullscreen(true)仅能隐藏状态栏，底部导航栏仍可见 -
navigationStyle: "custom"：彻底移除原生导航栏，此时plus.navigator.setFullscreen(true)才能真正作用于整个屏幕顶部区域 - 配套必须加
"app-plus": { "titleNView": false }，否则某些 Android 机型仍会渲染一个空白 title 区域，造成顶部留白
onShow 中调用 plus.navigator.setFullscreen(true)
这个 API 是隐藏状态栏的核心，但它有严格前提和时机要求：
- 必须在
onShow（或onLaunch）中调用，不能放在mounted或created—— Vue 生命周期早于 plus 环境就绪 - 需包裹
#ifdef APP-PLUS条件编译，否则 H5 或小程序会报plus is not defined - 单独调用它只能隐藏状态栏；若要连底部虚拟导航栏也隐藏，得额外加
plus.navigator.hideSystemNavigation()，但注意：该方法在部分 Android 12+ 厂商定制系统（如小米 HyperOS）上已失效，属于系统限制，非代码问题
横屏场景下必须 lockOrientation + manifest 配置双保险
很多“全屏失败”其实是因为横屏没锁死，导致系统自动恢复竖屏并重绘状态栏：
- manifest.json 的
app-plus → orientation必须显式声明：["landscape-primary", "landscape-secondary"]，否则 iOS 会直接忽略lockOrientation - App.vue 的
onLaunch中调用plus.screen.lockOrientation('landscape-primary')，而非onShow—— 启动即锁定，避免闪屏 - 如果只是局部页面需要横屏全屏，务必在
onHide中调用plus.screen.unlockOrientation()和plus.navigator.setFullscreen(false)，否则退出后其他页面也会被强制全屏
真全屏 ≠ 沉浸式，别混淆 setFullscreen 和透明导航栏
很多人误以为把原生导航栏设成透明就是全屏，其实不是：
-
setFullscreen(true)是系统级隐藏，状态栏区域完全不可见、不可滑出，内容真正顶到物理屏幕边缘 -
transparentTitle: "always"是让原生导航栏变透明，但其占位仍在，且用户从顶部下滑仍可能唤出状态栏（尤其在 Android 上） - 若你用了
navigationStyle: "custom"却发现顶部仍有 20px 黑边或白边，大概率是没关titleNView，或未在onShow里调setFullscreen，而不是样式问题
最易被忽略的一点：iOS 真机上，hideSystemNavigation() 无效果（iOS 本就没有虚拟导航栏），而 Android 部分新机型即使调用成功，用户从底部上滑仍会临时唤出导航栏——这不是 bug，是系统设计。所谓“真全屏”，本质是最大限度压制系统 UI，但永远受制于平台策略。
