uni.setNavigationBarColor在uni-app x中仅支持frontColor，background无效；APP端需关闭原生导航栏才生效；小程序需同时传frontColor和backgroundColor；H5不支持。
uni.setNavigationBarColor 不起作用？先看平台和前提条件
这个 API 在 APP 端（iOS/Android）和小程序端行为差异极大，且在 uni-app x 下完全失效——状态栏背景色恒为透明，uni.setNavigationBarColor 无法设置背景，只能改前景色（frontColor）。所以如果你在 uni-app x 项目里调用它却没反应，不是代码错，是设计如此。
常见错误现象：backgroundColor 设了但状态栏还是白的/黑的/系统默认色；frontColor 改了但文字颜色没变；H5 端调用直接报错或无效果。
- APP 端：必须关闭原生导航栏（即启用自定义导航栏）才能让
uni.setNavigationBarColor生效；否则它只影响原生导航栏区域，不控制状态栏 - 微信小程序：支持
uni.setNavigationBarColor，但frontColor和backgroundColor必须同时传，缺一不可 - H5 端：该 API 不支持，调用无效，别白费劲
- 鸿蒙、快应用等平台需查对应文档，不能默认兼容
pages.json 里 statusbar 配置怎么写才真正生效
想全局统一控制状态栏背景色，最稳妥的方式是走 pages.json 的 statusbar 配置，但它只在 APP 端有效，且有隐藏约束：一旦配置了 statusbar.background，系统会自动把状态栏区域“撑高”，导致页面内容上移——你不再需要手动加一个 view 占位，但也要注意原有布局是否被顶出可视区。
实操建议：
- 在页面级
style中配（推荐）：{"path": "pages/home/index", "style": {"app-plus": {"statusbar": {"background": "#1e40af"}}}} - 全局配（慎用）：
globalStyle下加app-plus.statusbar，会影响所有页面，夜间模式切换时难动态更新 - 如果同时设了
"immersed": false，状态栏会“收进”顶部，失去沉浸感，background配置也会被忽略
自定义导航栏下，状态栏颜色靠 CSS + statusBarHeight 实现
当你在 pages.json 中设了 "navigationStyle": "custom"，就彻底放弃了原生导航栏和状态栏控制权。此时状态栏变成“透明窗口”，颜色只能靠页面自己画出来——也就是在页面顶部放一个 view，高度设为 statusBarHeight，再给它填色。
关键点：
-
uni.getSystemInfoSync().statusBarHeight必须在onLoad或onShow里取，不能写死（不同机型值不同，iPhone X 系列是 44px，安卓多为 24–30px） - CSS 中要用
position: fixed+top: 0，否则滚动时会跟着动；z-index至少大于页面其他元素 - 别漏掉
--status-bar-height这个 CSS 变量，uni-app 会自动注入，但仅限于启用了titleNView: false的页面
示例片段：<view :style="{ height: statusBarHeight + 'px' }" class="status-bar"></view>.status-bar { background-color: #0d9488; position: fixed; top: 0; left: 0; width: 100%; z-index: 999; }
uni-app x 下状态栏必须“手绘”，且前景色才是唯一可控项
这是最容易被忽略的硬限制：从 2026 年起，uni-app x 明确声明状态栏背景色恒为透明，uni.setNavigationBarColor 的 backgroundColor 参数被忽略。你唯一能干预的是文字/图标颜色（frontColor），比如设成 #000000 让时间、信号图标变黑。
这意味着：
- 想实现“深色状态栏+浅色文字”，只能靠自定义 view 覆盖整个状态栏区域，并把文字图标配成白色（比如用 iconfont 或 SVG）
- 不要试图在
pages.json里配statusbar.background，x 版本不读这一项 - 若项目已升级到 x，老项目中靠
statusbar配置生效的逻辑要全部重写
复杂点在于：不同平台状态栏渲染机制不同，iOS 是独立系统控件，安卓是 Window 层级，而 uni-app x 把它们统一抽象成“透明容器”。这不是 bug，是架构选择——你要适配，而不是绕过。
