不能直接用 statusbarheight 计算 top 值，因其仅表示状态栏高度，不包含导航容器阴影、动态安全区、厂商定制差异等；应优先使用 env.safearea.top（小程序）、--window-top（三端）或 plus.navigator.getstatusbarheight（app）。
直接用 statusBarHeight 计算导航栏或 fixed 元素的 top 值，是导致定位偏差最常见、最隐蔽的根源——它在 iOS 刘海屏、Android 多窗口、横竖屏切换等场景下几乎必然出错。
为什么 statusBarHeight 不能直接当 top 用
这个值只代表「状态栏本身高度」，不包含：微信/支付宝小程序中 navigationStyle: "custom" 下预留的导航容器阴影和分割线（实际多出 40–52px）；iOS 动态安全区（锁屏后 env.safeArea.top 可能从 59px 突变为 24px）；Android 厂商定制系统（如 EMUI、MIUI）返回的 statusBarHeight 常滞后或固定为 25px，而真实安全区顶部可能已达 88px。
- 在
created或mounted钩子中就读uni.getSystemInfoSync().statusBarHeight，此时页面还没进入小程序容器上下文，值不可靠 - 把
statusBarHeight + 44当作导航栏总高，在 iPhone 14 Pro 上会少算约 20px，文字被“吃掉”顶部 - H5 端该值恒为 0，若未条件编译就参与计算，
top: 0直接贴顶，内容被截断
小程序端必须用 env.safeArea.top 替代
微信、支付宝、QQ 小程序在 onLoad 后注入 env 对象，其中 env.safeArea.top 是唯一反映真实可用顶部安全距离的数值。它动态响应刘海、灵动岛、折叠屏、横竖屏切换，且无需异步等待。
- 必须在
onLoad生命周期内读取，不要提前；onShow或onResize中可做二次校准 - 需 fallback：当
env?.safeArea?.top不存在时（极少数旧版支付宝），降级用uni.getSystemInfoSync().statusBarHeight - 不要用
uni.getMenuButtonBoundingClientRect()的top值直接当导航栏上边距——它返回的是胶囊按钮左上角坐标，不是安全区边界
H5 和 App 端要彻底隔离逻辑
H5 没有状态栏概念，--status-bar-height 是 0，uni.getSystemInfoSync().statusBarHeight 返回值无效；App 端则应优先使用 CSS 变量 --status-bar-height（nvue 页面）或 plus.navigator.getStatusBarHeight()（vue 页面），而非 JS 侧硬编码。
- H5 端导航栏高度写死为
44px，用padding-top: 44px或top: 0; height: 44px，别算、别猜、别依赖任何运行时变量 - App 端若用 vue 模板，
plus.navigator.getStatusBarHeight()比uni.getSystemInfoSync()更准，且支持监听plus.navigator.addEventListener('statusbarchanged') - 三端共用导航组件时，用
// #ifdef H5/// #ifdef MP-WEIXIN/// #ifdef APP-PLUS切逻辑，避免运行时判断平台带来的延迟或误判
fixed 元素定位必须用 --window-top 而非 statusBarHeight
uni-app 提供的 --window-top 是专为解决原生导航栏遮挡问题设计的 CSS 变量，它在小程序和 App 端自动注入真实顶部偏移（含状态栏+导航栏容器），H5 端默认为 0，语义清晰、无副作用。
- 写法：
style="top: var(--window-top); position: fixed;"，比手动拼calc(var(--status-bar-height) + 44px)更安全 - 注意：该变量仅在页面根元素或其子元素中生效，嵌套在
scroll-view或swiper内部时可能失效，需提升作用域 - 若同时用了自定义 tabbar，还需叠加
--window-bottom控制底部位置，避免被原生 tabbar 截断
真正难的不是读哪个值，而是意识到「状态栏高度」从来就不是个静态常量——它是设备能力、系统版本、容器实现、用户设置共同作用的结果。每次你用 statusBarHeight 做定位计算，本质上是在赌这些变量不会变。而生产环境里，它们永远在变。
