uni.setnavigationbarcolor在app端设background无效，是因为未关闭原生导航栏；必须设置"navigationstyle": "custom"并手动添加状态栏占位元素着色，否则api仅作用于原生导航栏而非状态栏。
uni.setNavigationBarColor 在 APP 端设 background 无效？先关原生导航栏
APP 端调用 uni.setNavigationBarColor 后状态栏背景没变，大概率是因为没关原生导航栏。这个 API 只在启用自定义导航栏（即 "navigationStyle": "custom"）时才真正控制状态栏区域；否则它只改原生导航栏的背景，状态栏仍由系统接管。
实操建议：
- 在
pages.json对应页面加"navigationStyle": "custom" - 确认
app-plus节点下没同时配置titleNView—— 它会和custom冲突，导致状态栏行为不可控 - 关闭原生导航栏后，状态栏变成“透明窗口”，此时你得自己画背景（见下一条）
用了 custom 却还是白/黑底？你没给状态栏“上色”
"navigationStyle": "custom" 不等于“自动透明”，它只是把控制权交给你——但你不手动加一层 view 占位并填色，状态栏就裸露为系统默认色（iOS 白、Android 黑）。
常见错误现象：
- 写了
page { background: transparent }，但状态栏还是白的 - 导航栏容器设置了
background-color: transparent，但顶部一片空白或发灰
正确做法：
- 根容器加
padding-top: var(--status-bar-height)（不是固定20px） - 在页面顶部放一个
<view class="status-bar-fill"></view>，高度设为var(--status-bar-height)，再给它background: #1e40af或background: rgba(0,0,0,0.1) - 别依赖
uni.getSystemInfo拿高度 ——--status-bar-height是 uni-app 注入的 CSS 变量，更准、跨平台适配好
小程序端 background 传了却没反应？frontColor 和 backgroundColor 必须成对出现
微信小程序要求 uni.setNavigationBarColor 的两个参数必须同时传，缺一不可。只传 backgroundColor 或只传 frontColor，整个调用都会静默失败。
另外注意格式限制：
-
frontColor只支持"#000000"或"#ffffff"（小写、无空格、6位） -
backgroundColor值不能是transparent或带 alpha 的rgba—— 小程序不认，会回退为默认色 - H5 端直接不支持该 API，调用无效果也不报错，别在这浪费调试时间
pages.json 里配了 statusbar.background 却没生效？检查 immersed 和 navigationStyle 冲突
pages.json 中的 app-plus.statusbar.background 看似简单，但有两个隐藏开关会把它废掉：
- 如果同时设了
"immersed": false，状态栏会被“收进”顶部，background配置直接被忽略 - 如果页面启用了
"navigationStyle": "custom"，statusbar配置就完全失效 —— 因为此时状态栏已不属于原生系统管理范围 - 全局配
globalStyle.app-plus.statusbar很难动态切换（比如夜间模式），推荐按页面单独配
真机调试时，务必用正式打包的 IPA/APK 测试 —— HBuilderX 模拟器对状态栏渲染有偏差，测出来“有效”不等于上线能用。
