必须手动用padding-top: var(--status-bar-height)占位，否则内容从(0,0)开始渲染会遮挡状态栏文字；--status-bar-height在部分机型上不准，需fallback js动态获取或原生桥接。
navigationStyle: custom 时状态栏文字被吃掉
设了 navigationStyle: "custom" 就必须自己撑开状态栏空间，否则页面内容从 (0,0) 开始画，直接盖住系统状态栏的文字和图标。这不是 bug，是预期行为——uni-app 把控制权交给你了，但没帮你留白。
常见现象：华为 Mate 50 Pro 上标题文字顶部被裁掉 2px、小米 14 全屏模式下整个导航区域下移 16px 出现白边、OPPO Find X6 横屏瞬间 statusBarHeight 变成 0 导致塌陷。
- 别依赖
uni.getSystemInfoSync().statusBarHeight的初始值，它不响应横竖屏切换或折叠屏展开 - 安卓 13+ 设备（如 Pixel 8）启用刘海透明化后，
onResize不触发，得用原生桥接监听WindowInsets - 真机调试时优先打印
plus.android.importClass("android.view.WindowInsets")获取原始系统 inset 值，比 JS 层 API 更准
用 CSS 变量撑开状态栏但高度不准
var(--status-bar-height) 是 uni-app 提供的 CSS 变量，但它在部分机型上返回 0 或固定值（比如华为 EMUI 12+ 返回 24dp 而非动态值），尤其在多窗口分屏、横竖屏切换后失效。
直接写 height: var(--status-bar-height) 很容易撑不够或撑过头，导致文字发虚或下方留白。
- 建议 fallback 到 JS 动态注入：在
onLoad中调用uni.createSelectorQuery()查询.status-bar-placeholder高度并重设样式 - 对 Android 13+ 设备，需通过原生插件桥接
getStatusBarHeight()，不能只靠 webview 容器层的计算 - 避免在
App.vue全局设置该变量，不同页面可能需要不同适配逻辑（比如首页要沉浸、设置页要常规）
mainfest.json 关闭沉浸式不生效
在 mainfest.json 的 app-plus → statusbar 下加 "immersed": false 看似简单，但实际只影响原生导航栏是否“沉”进状态栏，不解决自定义导航栏的定位问题。
如果你已经用了 navigationStyle: "custom"，关掉沉浸式只是让原生栏消失，页面依然从顶边开始渲染——你还是得手动处理状态栏占位。
- 这个配置对
navigationStyle: "default"页面才真正起作用 - 部分低端 Android 机型（如某些联发科方案）根本不支持
immersed: false，会静默忽略 - 改完必须重新打包（HBuilderX 中右键项目 → “发行” → “原生App-云打包”），仅热更新无效
uni-nav-bar 的 statusBar 组件兼容性陷阱
引入 @/uni_modules/uni-nav-bar/components/uni-nav-bar/uni-status-bar 确实能快速占位，但它内部依赖 uni.getSystemInfoSync()，在 vivo OriginOS 或小米 HyperOS 上横竖屏切换后不会刷新高度，导致白边或重叠复现。
更麻烦的是，该组件默认使用 position: fixed，在某些滚动容器里会被层级覆盖（比如 scroll-view 内部的 sticky 导航条）。
- 不要无条件全局注册，按需在特定页面 import 并局部注册
- 若页面含
scroll-view或自定义下拉刷新，把statusBar放在scroll-view外层，否则 fixed 定位会失效 - 遇到字体发虚，不是颜色问题，而是高 DPR 屏幕下 1px 边框未做缩放补偿，需额外加
transform: scale(0.5)或媒体查询适配
最易被忽略的一点：状态栏适配不是一次写死就能一劳永逸的事。厂商定制系统对 WindowInsets 的实现差异极大，同一台手机开启「全屏显示」「圆角裁剪」「分屏」任意一个开关，都可能让原有高度计算完全失准。真机测试不能只跑一台，至少覆盖华为、小米、OPPO、vivo 四家主流机型的最新系统版本。
