navigationBarTextStyle仅在navigationStyle: "default"时生效；设为"custom"后该配置被忽略，需手写导航栏并用CSS控制文字颜色，配合statusBarHeight适配安全区。
不能靠 navigationBarTextStyle 一设了事——它只在 navigationStyle: "default" 时生效；一旦你用了自定义导航栏（"custom"），这个字段就被完全忽略。
uni-app里navigationBarTextStyle什么时候有效
这个配置项只在页面启用默认导航栏、且平台支持时才起作用：
- App 端：需
navigationStyle: "default"，且必须配合原生层设置（如 iOS 的UIViewControllerBasedStatusBarAppearance启用） - 微信小程序：同样要求
navigationStyle: "default"，值只能是"white"或"black"，不支持十六进制色值 - H5：完全无效，浏览器无权控制状态栏文字颜色
- 如果 pages.json 中某页设了
"navigationStyle": "custom"，那这页的navigationBarTextStyle配置会被直接跳过
自定义导航栏后状态栏文字颜色怎么改
此时你已放弃原生导航栏控制权，状态栏变成“透明窗口”，文字颜色无法由 JS 配置驱动，只能靠视觉模拟 + 原生桥接：
- 微信小程序：手写导航栏区域，用 CSS 控制
<text>或<view>的文字颜色（如color: #000000），再通过uni.getSystemInfoSync().statusBarHeight或uni.getMenuButtonBoundingClientRect()获取高度做安全区适配 - App 端（Android/iOS）：必须调用原生 API，例如
plus.navigator.setStatusBarStyle("light")或uni.setNavigationBarColor({ style: "black" })；注意style参数仅 App 端识别，且必须在onReady后调用（onLoad太早，plus对象未就绪） - 别指望 H5 实现真修改——所有“状态栏变黑”都是用
padding-top挤出空间 + 顶部view填色的伪方案
uni.setNavigationBarColor 的常见误用和限制
这个 API 经常被当成万能开关，但它根本不管状态栏文字颜色（除了 App 端的 style 参数）：
- 小程序端：只接受
frontColor（#000000 或 #ffffff）和backgroundColor两个必填参数，缺一不可；frontColor控制的是导航栏内文字/图标色，不是状态栏文字 - App 端：
style: "black"才影响状态栏文字色（浅色背景配深色字），但需确保navigationBarBackgroundColor同时设置，否则部分安卓机型（如华为 EMUI）会忽略 - uni-app x 项目中该 API 完全失效——状态栏背景恒为透明，
backgroundColor不起作用 - 不能在
created或onLoad早期调用，建议加setTimeout(..., 100)或放onReady
动态切换状态栏文字颜色的正确姿势
响应式绑定 navigationBarTextStyle 是无效的，它不是响应式字段；真要动态改，得走平台差异化路径：
- 微信小程序：监听
wx.onThemeChange，在回调中重新调用uni.setNavigationBarColor（注意只对 default 导航栏有效）；首次进入用wx.getSystemInfoSync().theme判断当前模式 - App 端：封装一个方法，在主题切换时调用
plus.navigator.setStatusBarStyle（iOS）或uni.setNavigationBarColor({ style: ... })（Android），并确保原生权限已配置（如 AndroidManifest.xml 中的android:windowLightStatusBar） - 自定义导航栏场景下，所谓“动态切换”本质是切换你手写标题栏的
color值 + 重设状态栏背景view的background-color，和原生状态栏文字无关
最容易被忽略的一点：很多开发者在 pages.json 里写了 navigationBarTextStyle: "black"，却没检查对应页面是否真的用了 "default" 导航栏；只要有一处 "custom"，这个配置就形同虚设，而错误日志里也不会报任何提示。
