--status-bar-height 仅静态fallback，iOS动态指示条、折叠屏、微信小程序胶囊按钮等场景下失效，需结合运行时探测与平台判断；uni.getSystemInfoSync().statusBarHeight 各端行为不一，须用 getMenuButtonBoundingClientRect() 二次校验。
直接用 --status-bar-height 能解决大部分场景，但只靠它会在 iOS 动态指示条、折叠屏、微信小程序胶囊按钮对齐等情况下失效——必须配合运行时探测和平台判断。
为什么 --status-bar-height 有时不准
这个 CSS 变量在 H5 和部分小程序中是静态 fallback 值（比如固定 25px），根本没读取原生状态栏；iOS 15+ 录音红条、定位蓝条出现时，真实 statusBarHeight 会临时变高，但该变量不触发更新；微信小程序里它甚至不参与胶囊按钮对齐计算。
常见错误现象包括：
- iPhone 14 Pro 上顶部内容被动态指示条遮住
- 小米/华为曲面屏上导航栏“悬浮”在状态栏下方
- 折叠屏展开后导航栏高度没重算，内屏内容错位
uni.getSystemInfoSync().statusBarHeight 的实际表现差异
这个 API 返回值不是“物理高度”，而是 uni-app 抽象层的兜底结果，不同端行为不一致：
立即学习“前端免费学习笔记（深入）”；
- App 端：基本可靠，但 iOS 某些系统版本会返回
20px（未识别刘海） - 微信小程序：多数安卓机返回
25px，iPhone X+ 返回44px，但折叠态/多任务态不更新 - H5 端：强制返回
20或0，浏览器根本不提供该信息 - 鸿蒙端：需额外调用
ohos.app.ability.UIAbility.getContext()获取真实安全区
所以不能只信它返回的数字，得结合 uni.getMenuButtonBoundingClientRect() 做二次校验——尤其在小程序里，胶囊按钮的 top 值比 statusBarHeight 更可信。
小程序胶囊按钮导致的导航栏高度误算
微信小程序的右上角胶囊是硬性占位元素，它的位置决定了你自定义导航栏的最小可用高度。只用 statusBarHeight + 44 是错的。
正确公式是：
const menu = uni.getMenuButtonBoundingClientRect() const system = uni.getSystemInfoSync() const navHeight = menu.top + menu.height + (menu.top - system.statusBarHeight)
关键点：
-
menu.top是胶囊上边缘到屏幕顶部的距离，天然包含状态栏 - 这个值在 iPhone、折叠屏、MIUI 等环境下都比
system.statusBarHeight更准 - 如果
menu获取失败（如某些低端安卓机），必须 fallback 到system.statusBarHeight + 44，并加日志报警
H5 和 App 端如何避免“假装适配”
H5 端没有状态栏概念，--status-bar-height 是硬设的 fallback 值，不能用于计算真实布局偏移；App 端虽能读取系统值，但需注意刘海识别失败、横屏未更新等问题。
建议做法：
- 在
App.vue的onLaunch中统一初始化：document.documentElement.style.setProperty('--status-bar-height', statusBarHeight + 'px') - 对 H5 环境单独设置默认值（如
env === 'h5' ? 0 : statusBarHeight） - 所有使用
--status-bar-height的样式，必须配合safeAreaInsets.top做兜底（尤其鸿蒙和折叠屏）
真正可靠的适配，从来不是靠一个变量撑全场，而是分平台、分能力、有 fallback 的组合判断——尤其是胶囊按钮位置、动态指示条、安全区变更这些容易被忽略的实时信号。
