navigationBarTextStyle 在 navigationStyle: "custom" 时完全失效，因其仅对原生导航栏生效；custom 模式下需用 CSS 控制文字颜色或调用 uni.setStatusBarStyle（App 端）等原生 API。
navigationStyle: "custom" 时 navigationBarTextStyle 完全失效
这是最常被当成 bug 的“伪问题”：只要你在 pages.json 里把某个页面设为 "navigationStyle": "custom"，navigationBarTextStyle 就立刻失去作用——它只对原生导航栏生效，而 custom 模式下你已经亲手干掉了原生导航栏。iOS 和 Android 都一样，不是平台差异，是设计逻辑使然。
常见错误现象：
– 页面配置了 "navigationBarTextStyle": "black"，但状态栏文字仍是白色
– 切换主题后文字颜色不动，手动改 data 也无反应
– 在 H5 端调用或配置该字段，控制台静默忽略或报错
实操建议：
• 彻底移除 custom 页面的 navigationBarTextStyle 配置，它已无意义
• 如果你用的是手写 color 控制，例如 .nav-bar .title { color: #000000; }
• 微信小程序端若仍想走原生控制，只能退回 "navigationStyle": "default"，放弃自定义导航栏
App 端必须用 uni.setStatusBarStyle 而非 setNavigationBarColor
uni.setNavigationBarColor 只改导航栏背景色，不碰状态栏文字；真正控制文字明暗的是 uni.setStatusBarStyle，且仅在 App 端有效。很多人卡在这一步，是因为混淆了这两个 API。
关键细节：
• style 参数只接受 "light" 或 "dark"，没有中间值
• 必须在 onReady 后调用，onLoad 中 plus 对象可能未就绪
• iOS 需确保原生工程中 UIViewControllerBasedStatusBarAppearance 为 YES，否则 JS 调用被无视
• Android 部分机型（如 MIUI）会强制跟随系统深色模式，需监听 plus.navigator.getStatusBarStyle() 并重设
示例代码：
onReady() {<br> setTimeout(() => {<br> uni.setStatusBarStyle({ style: 'dark' });<br> }, 100);<br>}
H5 端根本无法修改状态栏文字颜色
这不是 bug，是浏览器能力限制：Safari、Chrome 等所有主流 H5 浏览器均不提供控制状态栏文字颜色的 API。任何尝试调用 uni.setNavigationBarColor、navigationBarTextStyle 或注入 CSS 变量的操作，在 H5 下都注定失败。
能做的只有视觉模拟：
• 顶部加一个固定高度的占位
• 高度设为 20px（iOS 标准）或通过 UA 判断后动态设置
• index.html 的 必须含 viewport-fit=cover
• 别在 H5 分支里保留任何状态栏颜色相关 JS 调用，直接删掉，避免运行时报错
微信小程序端无法“自由设色”，只有 light/dark 二选一
微信原生机制只支持两种状态栏文字样式：light（白字）和 dark（黑字），不支持 RGB、HEX 或透明度。uni-app 的 navigationBarTextStyle 实际只是透传这个开关，且仅在 navigationStyle: "default" 时起效。
如果你用了 custom 导航栏：
• 放弃对 navigationBarTextStyle 的幻想，它已断连
• 手写标题文字颜色由 CSS 决定，例如 color: #ffffff 或 color: #333333
• 如需响应系统深色模式，必须手动监听：
– 首次进入用 wx.getSystemInfoSync().theme
– 后续变化用 wx.onThemeChange（基础库 ≥2.11.0）
• 注意：H5 和 App 端无 wx.onThemeChange，必须条件编译隔离
最容易被忽略的点是：状态栏文字颜色从来不是纯前端可编程的“样式属性”，它始终依赖原生层能力。custom 导航栏 ≠ 自由控制状态栏，而是把控制权从 uni-app 手中移交给了你——你要么用 CSS 模拟文字，要么桥接到原生 API，没有第三条路。
