uni.setNavigationBarColor不能直接设置状态栏颜色，需按平台差异处理：APP端需关闭原生导航栏并自定义view；小程序需严格传入小写6位十六进制frontColor；H5依赖meta标签；uni-app x已移除background参数。
不能直接用 uni.setNavigationBarColor 设置状态栏背景色为任意十六进制颜色——它在多数平台根本不管状态栏，只管导航栏；真要填色，得看平台、看导航栏模式、看是否启用原生控制权。
APP端关闭原生导航栏后，状态栏才真正“可涂色”
当你在 pages.json 里设了 "navigationStyle": "custom"，就等于把状态栏区域让渡给页面自己画。此时 uni.setNavigationBarColor 完全失效，状态栏变透明，你必须手动加一个 view 占位并上色。
-
uni.getSystemInfoSync().statusBarHeight必须在onLoad或onShow中取，不能写死（iPhone 15 Pro 是 50px，华为 Mate 60 是 28px） - CSS 要用
position: fixed; top: 0; width: 100%; z-index: 9999，否则滚动时会错位或被遮挡 - 颜色值必须是严格十六进制格式，如
#1e40af，rgb(30, 64, 175)或带空格的" #1e40af"都会失败 - 如果用了条件编译（如
#ifdef APP-PLUS），记得同时处理 iOS 和 Android 的statusBarHeight差异，别只测安卓忘了 iPhone X 系列的刘海区
微信小程序：background 需和 frontColor 同时传，且仅支持 #000000 / #ffffff
小程序端的 uni.setNavigationBarColor 表面能设状态栏，实则只影响导航栏+状态栏组合区域，而且有硬约束：
-
frontColor只接受"#000000"或"#ffffff"（注意：必须小写、无空格、6位）；传"black"或"#fff"直接静默失败 -
backgroundColor可以是任意合法十六进制色（如"#8b5cf6"），但若frontColor不合规，整个调用会被忽略 - 必须在页面
onLoad中调用，onShow后再调可能不生效（尤其 tabbar 页面） - 全局配置无效，必须每个页面单独设，或通过
app.js的onLaunch+ 页面级缓存逻辑模拟“动态”
H5端：iOS Safari 只认 <meta name="theme-color">
H5 在 iOS 上根本没有 JS 控制状态栏的 API，Safari 唯一响应的是 <meta> 标签。但它极难驯服：
-
<meta>必须在index.html的<head>里，且要有id="themeColor"方便 JS 定位 - 动态切换时不能直接改
content，得先清空再赋值，否则 Safari 缓存旧值——常见写法：document.getElementById('themeColor').content = ''→setTimeout(() => { ... }, 100) - 颜色必须是纯十六进制（
#ff6b35），rgba()、变量、CSS 变量全无效 - SPA 路由切换不会触发重绘，所以每次
onShow都得手动重置，否则地址栏颜色卡在上一页
uni-app x 下：background 参数被彻底移除，只能改文字颜色
如果你用的是 uni-app x（非 Vue 版），uni.setNavigationBarColor 的 backgroundColor 字段已废弃。官方明确说明：状态栏背景恒为透明，JS 层无法干预。
- 唯一能动的是
frontColor，且只支持"#000000"和"#ffffff" - 想实现背景色？只能走自定义导航栏路线，和 APP 端 custom 模式一致：用
view+statusBarHeight+ 固定定位 - 别在
uni-app x项目里写backgroundColor，它编译时不会报错，但运行时完全不解析 - 如果你正在迁移老项目到
uni-app x，这个限制必须在架构初期就确认，否则后期返工会极大
最常被忽略的一点：状态栏颜色不是独立样式，它和导航栏模式、系统深色模式、厂商定制 UI（如 MIUI 强制跟随系统）、甚至 iOS 的 UIViewControllerBasedStatusBarAppearance 设置强耦合。没真机覆盖测试，光靠模拟器或 H5 预览，大概率上线才发现白屏或文字不可读。
