H5端无法修改状态栏颜色，因iOS Safari不提供API，所谓“变色”是页面顶到顶部与系统状态栏视觉冲突所致；唯一方案是CSS占位（20px高）+ viewport-fit=cover。
uni-app页面跳转后状态栏颜色变了，H5端根本没法改
直接说结论：H5端调用uni.setNavigationBarColor、navigationBarTextStyle或在pages.json里配statusbar，全部无效。iOS Safari 不暴露任何控制状态栏的 API，所谓“颜色变了”，其实是页面内容顶到了顶部，和系统默认状态栏（白底黑字/黑底白字）视觉冲突造成的错觉。
唯一能做的，是用 CSS 占位 + 视觉对齐：
- 在页面顶部加一个
<view class="status-bar-placeholder"></view>，高度硬编码为20px（iOS 标准值），背景色与你的自定义导航栏一致 - 导航栏组件用
position: fixed; top: 20px;起始，别设top: 0，否则文字会被系统状态栏裁切 -
index.html或manifest.json里的<meta name="viewport">必须含viewport-fit=cover，否则 Safari 会强制留白 - 别用
env(safe-area-inset-top)——它只在 Safari 支持，且需viewport-fit=cover配合，H5 其他浏览器不认
App端跳转后状态栏颜色闪变或卡旧值
这不是样式没更新，而是原生层状态未同步。App 端状态栏由系统独立管理，路由切换时不会自动重载，尤其在非 nvue 模式下，web-view 渲染会复用初始主题色缓存。
关键动作是：在目标页面的onShow里主动设置，而不是onLoad：
-
onLoad太早，plus对象可能未就绪；onShow确保页面已激活，可安全调用原生 API - App 端必须用
plus.navigator.setStatusBarStyle("light")或"dark"，不是uni.setNavigationBarColor（后者只影响原生导航栏背景，不控状态栏文字） - 如果用了自定义导航栏（
navigationStyle: "custom"），navigationBarTextStyle完全失效，必须靠plus.navigator.setStatusBarStyle或条件编译桥接 - 避免在
globalStyle里全局配statusbar.background——夜间模式切换时无法动态更新，容易卡在上一页颜色
小程序端跳转后状态栏颜色不还原
微信小程序对状态栏控制较严格，但有个隐藏前提：只有启用默认导航栏（navigationStyle: "default"）时，navigationBarTextStyle才生效；一旦设为"custom"，该字段被忽略，且uni.setNavigationBarColor必须同时传frontColor和backgroundColor才起作用。
常见踩坑点：
- 子页面的
navigationBarTextStyle不会继承app.json配置，必须在pages.json中为每个页面单独声明 - 调用
uni.setNavigationBarColor前，先确认当前页面是否启用了原生导航栏（即没设"custom"），否则无效果 - 小程序真机调试时，部分安卓机型状态栏文字颜色受厂商系统深色模式强制干预，
frontColor可能被覆盖 - 不要在
data里绑定navigationBarTextStyle——它不是响应式字段，动态切换必须走 API 或重新加载页面
为什么onPageScroll监听不到滚动，导致渐变失效
很多人想用滚动实现状态栏颜色渐变，结果发现onPageScroll根本不触发——这通常是因为页面结构不符合触发条件。
必须满足以下所有条件，onPageScroll才会返回{ scrollTop }：
- 该生命周期仅在
pages.json注册的页面级组件中生效，子组件需通过$parent或事件透传获取 - 页面根容器必须是原生滚动容器：H5 默认可用；小程序端若没包裹
<scroll-view>，iOS 微信可能不触发（尤其开启下拉刷新时） - 不能把
onPageScroll写在components目录下的 Vue 文件里，它只属于页面实例 - 节流处理必不可少：真机上回调频率不稳定（16ms～60ms），直接更新样式易卡顿，建议用
requestAnimationFrame合并计算
最常被忽略的一点：状态栏本身不支持透明度动画，uni.setNavigationBarColor只接受预设色值（如"#ffffff"），渐变逻辑只能作用于自定义导航栏的background-color，而非状态栏。
