navigationBarTextStyle 仅在 navigationStyle: "default" 时生效；设为 "custom" 后完全失效，需通过 plus.navigator.setStatusBarStyle 或自定义 CSS 控制文字色。
直接说结论：navigationBarTextStyle 只在 navigationStyle: "default" 时生效；一旦设为 "custom"，它就完全失效，切勿再指望它控制状态栏文字颜色。
为什么 navigationBarTextStyle 设了 black/white 却没反应？
这是最常踩的坑：你启用了自定义导航栏（navigationStyle: "custom"），但还在 pages.json 里配 navigationBarTextStyle: "black"——这个字段此时被 uni-app 忽略，iOS 和 Android 都不会读取它。
- 只有原生导航栏（
"default"）才走这套配置逻辑；"custom"意味着你已接管整个顶部区域，状态栏文字色由系统或原生层决定 - 微信小程序端：即使配了
navigationBarTextStyle，只要页面级navigationStyle是"custom"，该字段就透传不到微信原生层 - App 端：此时
navigationBarTextStyle不再起作用，必须调用plus.navigator.setStatusBarStyle("dark")或"light"
App 端动态切换状态栏文字为 black/white 的正确写法
不能靠 data 响应式绑定，也不能在 onLoad 立刻调用；必须等原生环境就绪后，用 plus API 主动设置。
- 务必放在
onReady中执行，onLoad时plus对象可能未初始化 - 只接受两个字符串值：
"dark"（黑字）、"light"（白字），不是十六进制色值 - Android 需提前在
manifest.json → app-plus → android → permissions中声明WRITE_SETTINGS（仅调试），否则部分机型（如 MIUI）会静默失败 - iOS 要求
Info.plist中UIViewControllerBasedStatusBarAppearance为YES，否则 JS 调用无效
onReady() {
if (uni.getSystemInfoSync().platform === 'app') {
setTimeout(() => {
// 延迟确保 plus 就绪
plus.navigator.setStatusBarStyle('dark'); // 黑字
// 或 plus.navigator.setStatusBarStyle('light'); // 白字
}, 100);
}
}
微信小程序里“模拟”黑/白字的实操方式
小程序原生不支持任意颜色，只认 light/dark 模式；但你在自定义导航栏里完全可以自己画文字，颜色由 CSS 控制——这才是真正可控的方式。
- 先在
pages.json中确认该页面是"navigationStyle": "custom" - 用
uni.getSystemInfoSync().statusBarHeight获取高度（真机可靠，开发者工具可能返回 0，建议 fallback 到 44） - 在页面
<template>中写一个固定定位的标题栏，高度含状态栏，并用color: #000000或#ffffff控制字体色 - 若需跟随系统深色模式，监听
wx.onThemeChange并更新 data，驱动 class 切换
注意：uni.getMenuButtonBoundingClientRect() 返回的 top 值减去已知安全区偏移，比单纯依赖 statusBarHeight 更准，尤其在刘海屏机型上。
H5 端根本没法改状态栏文字颜色
浏览器不提供任何 API 控制状态栏文字色，所有“H5 修改状态栏颜色”的说法都是伪需求。所谓“修改”，最多是用 padding-top + env(safe-area-inset-top) 模拟顶部留白，但状态栏本身仍是系统默认样式。
别在 H5 条件编译里写 uni.setNavigationBarColor 或 plus.navigator.setStatusBarStyle，它们要么报错，要么静默忽略——这不是 bug，是平台限制。
真正容易被忽略的是：不同平台对“状态栏文字颜色”的控制粒度完全不同。iOS 和 Android 的原生机制、厂商定制、系统版本都会覆盖 JS 层设置，真机测试必须覆盖主流机型，不能只信开发者工具表现。
