statusBarHeight 经常为 0 是因 H5/部分安卓 WebView/低版本小程序不支持该字段，需封装兜底函数返回 0 并在 onLoad 或 onShow 中获取；CSS 使用 env(safe-area-inset-top) 前必须设置 viewport-fit=cover，且仅限 iOS；自定义导航栏顶部留白应使用 padding-top 而非 margin-top。
uni.getSystemInfoSync() 返回的 statusBarHeight 为什么经常是 0？
因为这个值不是“永远可靠”的——iOS 真机上它通常能拿到（如 iPhone 14 Pro 是 49），但 H5 端很多浏览器（尤其微信内置浏览器、部分安卓 WebView）根本不提供该字段；小程序端在某些低版本基础库或调试工具里也可能返回 0 或 undefined。
所以不能直接写 statusBarHeight + 'px' 就完事，必须兜底。实操建议：
- 用封装函数统一获取，缺失时返回
0（不是硬编码20或44），让 UI 层自己决定是否降级显示 - 避免在
created阶段就依赖它——onLoad或onShow更稳妥，因为部分平台需异步初始化系统信息 - 别在 CSS 里写
top: calc(var(--status-bar) + 10px)这种依赖 JS 注入变量的方式，H5 和小程序都不支持运行时 CSS 变量注入
padding-top: env(safe-area-inset-top) 不生效？检查 viewport-fit=cover
这是最常被忽略的前提条件：env(safe-area-inset-top) 在 iOS Safari / WKWebView 中只有开启全屏渲染才可用。没加 viewport-fit=cover，这个 CSS 函数就永远返回 0。
实操建议：
- 在
index.html的里确保有： - 只对需要沉浸式布局的页面加，比如首页、详情页；登录页、设置页这类常规页面可不加，避免意外溢出
-
env()兼容 iOS 11+，constant()是 iOS 11.2–12.1 的临时替代，现在可只写env()（2026 年绝大多数设备已升级）
自定义导航栏顶部留白，该用 padding 还是 margin？
用 padding-top。原因很实际：如果你用 margin-top，父容器高度不会自动包含这块空白，滚动时可能触发非预期的粘滞或错位；而 padding-top 是内容区的一部分，和状态栏/刘海区域逻辑一致。
常见错误现象：
- fixed 定位的 header 设置了
top: 0，但内容从状态栏下方开始，导致顶部 10–20px 被遮挡 - 用了
env(safe-area-inset-top)却发现安卓机也跟着加了空白（因为安卓不识别 env，但你没做媒体查询隔离）
实操建议：
- 只在 iOS 设备上启用 env：用
@supports (padding-top: env(safe-area-inset-top))包裹样式 - 配合
uni.getSystemInfoSync().platform === 'ios'做 JS 层判断，双保险 - 如果用了自定义导航栏，把
statusBarHeight作为导航栏整体高度的一部分，而不是额外加 padding
pages.json 里设 titleNView: false 后内容顶到最上面，但状态栏还在 —— 怎么办？
这是 H5 和 App 端的典型表现：titleNView: false 只隐藏了 uni-app 渲染的导航栏，但系统状态栏（时间、信号、电量）依然存在，且内容会直接顶上去，被遮挡。
实操建议：
- 在页面根元素加内联 style：
:style="{ paddingTop: statusBarHeight + 'px' }"，其中statusBarHeight来自封装的getStatusBarHeight()函数 - 不要全局设
titleNView: false后就不管了——每个页面仍要主动处理状态栏占位，否则路由跳转后新页面没初始化 height 就会闪一下 - 微信小程序端不同：它没有
titleNView概念，而是靠navigationStyle: "custom"，此时必须手动撑高顶部区域，否则状态栏文字会压在你的内容上
刘海不是个独立区域，它是状态栏 + 安全区共同作用的结果；填不填、怎么填，得看平台、看渲染模式、看是否自定义导航栏——没有一劳永逸的 class，只有分场景的判断。
