uni.setNavigationBarColor需分平台处理：小程序须onReady中传full frontColor和backgroundColor；App端style仅控文字色且需原生配置；custom导航栏时需CSS模拟；H5无法真实控制；推荐用原生插件或CSS方案。
动态修改状态栏颜色不是调一个 API 就完事，得看平台、导航栏类型、甚至手机厂商——uni.setNavigationBarColor 在不同环境下行为差异极大，直接照搬容易白忙活。
uni.setNavigationBarColor 在小程序里怎么用才生效
微信/支付宝等小程序支持该 API，但有两个硬性条件必须同时满足：
-
frontColor和backgroundColor必须都传，缺一不可；只传一个，状态栏颜色不会变 - 必须放在
onReady钩子中调用，onLoad太早，部分平台（如微信）会忽略 - 不能写在
data或响应式逻辑里——它不监听变化，只执行一次
示例：
onReady() {
uni.setNavigationBarColor({
frontColor: '#ffffff',
backgroundColor: '#2d8cf0'
})
}
App 端状态栏文字颜色根本不能靠 setNavigationBarColor 控制
uni.setNavigationBarColor 的 style 参数（如 'black'）仅在 App 端生效，且只影响状态栏文字颜色，和背景色无关。但这里坑极多：
- iOS 必须在原生工程的
Info.plist中把UIViewControllerBasedStatusBarAppearance设为YES，否则 JS 调用完全无效 - Android 需要在
AndroidManifest.xml中添加android:windowLightStatusBar="true"才能让深色文字显示出来 - 调用时必须搭配
navigationBarBackgroundColor，单独设style在华为、小米等机型上会被无视 - 不能在
onLoad立即调，建议延迟100ms或改用onReady
用了 custom 导航栏，状态栏就彻底“失控”了
一旦在 pages.json 里设了 "navigationStyle": "custom"，uni.setNavigationBarColor 和 navigationBarTextStyle 全部失效——状态栏变成透明窗口，颜色得你自己画：
- 用
uni.getSystemInfoSync().statusBarHeight动态获取高度（iPhone X 是 44px，安卓常见 24–30px） - 在页面顶部加一个
<view>，position: fixed; top: 0; height: var(--status-bar-height); background-color: #ff0000; - 务必加
z-index: 999，否则可能被其他元素遮挡 - H5 端完全无法控制真实状态栏，这种“模拟”只是视觉补偿
真要跨平台动态换色，别硬刚 API
原生能力碎片化太严重，尤其遇到 MIUI、EMUI 强制跟随系统深色模式时，JS 设置大概率被覆盖。更稳的做法是：
- App 端用
Ba-AppBar这类原生插件，封装了各平台差异，调appBar.setStatusBar({ statusColor: '#000', isDarkFont: true })即可 - 小程序端保持
onReady + 双参数模式，别折腾style - 自定义导航栏场景下，放弃“控制状态栏”，转为统一用 CSS +
--status-bar-height模拟，反而更可控
最常被忽略的一点：iOS 13+ 后，系统级深色模式开启时，即使你 JS 调用了设置，状态栏也可能瞬间回退——得监听 plus.navigator.getStatusBarStyle() 变化并重设，否则用户切个系统主题，你的配色就丢了。
