H5端无法真正修改状态栏颜色，仅能通过viewport-fit=cover和env(safe-area-inset-top)实现视觉模拟；App端需关闭原生导航栏并正确配置参数才能生效。
做不到“让状态栏颜色和顶部背景一致”——H5端根本不能改状态栏颜色，iOS Safari 完全不提供该能力；所谓“一致”，只能靠视觉模拟，且仅对自定义导航栏有效。
uni.setNavigationBarColor 在 H5 调用就报错或无效
这个函数在 H5 端压根没实现，控制台显示 undefined is not a function 是设计如此，不是环境配置问题。别在 onLoad 或 onShow 里写它，也别用条件编译兜底——写了白跑，还可能干扰后续样式逻辑。
H5 在 iOS 上只能用 env(safe-area-inset-top) 做视觉对齐
真正在 Safari 地址栏下方形成“颜色延续感”的唯一可靠方式是 CSS 安全区适配：
-
meta[name="viewport"]必须含viewport-fit=cover（uni-app 默认已加，但检查 manifest.json 或 index.html 确保没被覆盖） - 页面最外层容器加
padding-top: env(safe-area-inset-top)，而不是写死20px或44px - 若用了自定义顶部栏（如
position: fixed），它的高度应为calc(44px + env(safe-area-inset-top))，背景色与导航栏一致 - 禁用
top: 0的 fixed 导航栏，否则它会无视安全区，直接顶到屏幕最顶，文字被裁切
App 端要关原生导航栏才能生效
在 App（iOS/Android）上，uni.setNavigationBarColor 只有在关闭原生导航栏后才真正控制状态栏区域：
- pages.json 中对应页面需设
"navigationStyle": "custom" - 调用时
backgroundColor和frontColor必须同时传（小程序同理） - Android 需确认
android:windowLightStatusBar已配置，iOS 需确保UIViewControllerBasedStatusBarAppearance为YES - 不能在
onLoad立即调用，建议延迟100ms或放onReady后
最容易被忽略的是：H5 的“状态栏颜色”其实是 Safari 地址栏底色，它只响应 meta[name="theme-color"]，且仅在硬跳转时更新。SPA 路由切换不会触发重载，所以必须在每个页面 onShow 里手动写入 document.querySelector('meta[name="theme-color"]').content = '#1e40af' —— 否则颜色永远卡在上一页。
