navigationBarTextStyle是控制状态栏字体颜色的唯一合法入口，仅在navigationStyle为"default"时对H5和小程序生效；设为"custom"后H5完全无视，App端需配合原生API，且只接受"white"或"black"。
状态栏字体颜色不能靠 CSS 或全局样式控制，navigationBarTextStyle 是唯一合法入口，但它是否生效，完全取决于 navigationStyle 值和当前平台能力。
pages.json 里设置 navigationBarTextStyle 生效的前提
这个字段只在 navigationStyle: "default" 时才被 H5 和小程序真正读取；设为 "custom" 后，它仅对 App 端和微信小程序端部分场景起作用（且需配合原生层），H5 完全无视。
-
navigationBarTextStyle只接受两个字符串值："white"或"black"，写成#ffffff或light都会失效 - App 端即使写了
"black"，若未在onReady中调用plus.navigator.setStatusBarStyle("dark")，仍可能显示为白色 - 微信小程序中，如果
app.json根节点的navigationStyle是"custom"，子页面的navigationBarTextStyle配置会被忽略
uni.setNavigationBarColor 动态改色时 frontColor 的坑
这个 API 的 frontColor 参数看起来像能控制状态栏文字，但它实际只影响导航栏内按钮和标题——**不控制状态栏本身**（尤其在自定义导航栏下）。很多人调用后发现状态栏没变，就是因为混淆了“导航栏前景色”和“状态栏文字色”。
-
frontColor必须是"#000000"或"#ffffff"，其他值如"#333"会被静默忽略 - 必须同时传
backgroundColor，缺一不可；否则整个调用无效 - 不能在
onLoad立即调用，iOS 和部分安卓机型要求至少延迟 100ms，或放在onReady之后 - 微信小程序中，该 API 在分包页面首次加载时可能不触发，建议加
try/catch并 fallback 到 pages.json 静态配置
App 端真机上状态栏文字不随 JS 设置变化？检查原生配置
JS 层调用 plus.navigator.setStatusBarStyle 或 uni.setNavigationBarColor({ style: "black" }) 失效，大概率是原生层被锁死。
- iOS：确认
Info.plist中UIViewControllerBasedStatusBarAppearance为YES，且没有硬编码[UIApplication sharedApplication].statusBarStyle - Android：检查
AndroidManifest.xml是否开启android:windowLightStatusBar="true"（对应深色文字），并确保 targetSdkVersion ≥ 23 - 华为/小米等厂商系统可能强制跟随深色模式，需监听
plus.navigator.getSystemDarkMode并主动重设 - 使用自定义基座调试时，务必清空旧基座缓存，否则 manifest.json 修改不生效
最易被忽略的一点：你在 pages.json 里写了 "navigationBarTextStyle": "black"，但页面用了 navigationStyle: "custom"，又没配原生桥接——此时状态栏文字实际由系统决定，JS 层已完全失权。
