必须在每个页面的onReady中调用uni.setNavigationBarColor且frontColor和backgroundColor缺一不可，因原生导航栏为页面级独立渲染，全局设置无效，onReady是唯一100%可靠的调用时机。
必须在每个页面的 onReady 生命周期里调用 uni.setNavigationBarColor，且 frontColor 和 backgroundColor 两个参数缺一不可——漏填任一个，颜色都不会生效。
为什么不能只写一次全局设置
小程序原生导航栏是页面级独立渲染的，App.vue 或 main.js 中的任何 JS 设置都无法跨页面生效；uni.setNavigationBarColor 的作用域就是当前页面上下文，上一个页面设的值不会带到下一个页面。
- 即使你在 App.vue 的
onShow里调用，也只对首页或前台切回时的当前页起作用，无法覆盖其他页面 - 使用
pages.json静态配置 navigationBarBackgroundColor 只能设默认值，无法响应页面逻辑变化（比如用户切换主题、进入夜间模式页） - 小程序不支持监听“页面切换完成”事件，所以没法在路由跳转后统一补设——只能靠每个页面自己负责
onReady 是唯一可靠时机
很多开发者在 onLoad 就调用，但此时原生导航栏可能尚未初始化完毕，尤其在 iOS 微信或部分安卓机型上会静默失败。实测 onReady 是最早且 100% 可靠的回调点。
-
onLoad：参数已读取，但 DOM 和原生容器未就绪，调用无效 -
onShow：适合处理前台切回场景，但首次进入页面时不一定触发（如从分享卡片打开） -
onReady：页面首次渲染完成，原生导航栏确定可用，此时调用必生效
示例：
onReady() {
uni.setNavigationBarColor({
frontColor: '#ffffff',
backgroundColor: '#2d8cf0'
})
}
常见错误：颜色没变，但代码没报错
这是最典型的静默失败，原因几乎全是参数缺失或格式错误：
- 漏掉
frontColor：哪怕只改背景色，也必须显式传入（如'#000000'或'#ffffff'） - 颜色值不是合法十六进制：带空格、大小写混用（
#FF0000可，#ff 00 00不可）、少了位数（#f00可，#f0不可） - 在 H5 或 App 端误用：该 API 仅在
MP-WEIXIN、MP-ALIPAY等小程序平台有效，H5 端调用无反应也不报错 - 自定义导航栏（
navigationStyle: custom）下无效：此时你渲染的是自己写的 view，uni.setNavigationBarColor控制的是原生导航栏，它已被隐藏
需要联动状态栏文字颜色？那是另一回事
uni.setNavigationBarColor 完全不控制状态栏文字（status bar text）颜色。如果你发现文字看不见，不是背景设错了，而是系统状态栏样式没同步：
- App 端需额外调用
uni.setNavigationBarColor({ style: 'black' })（仅 App 支持），且必须和backgroundColor同次调用 - 小程序端（微信/支付宝）状态栏文字颜色由
frontColor决定：传'#000000'文字变黑，'#ffffff'变白，无需额外 API - iOS 真机若始终不生效，检查原生工程中
UIViewControllerBasedStatusBarAppearance是否为YES，否则 JS 设置被系统接管
真正容易被忽略的是：不同平台对同一套参数的容忍度差异极大——微信能接受的写法，支付宝可能直接忽略；一次写对，不代表所有小程序都生效。务必在目标平台真机验证。
