uni.setNavigationBarColor的style参数仅App端生效，取值为"default"（浅色文字）或"black"（深色文字），H5和小程序不支持；需配合navigationBarBackgroundColor使用，且不能在自定义导航栏（navigationStyle: "custom"）下使用。
uni.setNavigationBarColor 的 style 参数只在 App 端生效
很多人以为 uni.setNavigationBarColor 能统一控制导航栏背景和状态栏文字颜色，其实它只改背景色；style 字段才是专门管状态栏文字颜色的，但仅限 App（iOS/Android），H5 和小程序完全忽略该参数。
这个 style 只接受两个字符串值："default" 和 "black"。注意不是 "light"/"dark" —— 这是常见拼写错误，传错值会导致调用静默失败，状态栏文字颜色不变。
-
"default"：系统默认样式，通常是浅色文字（白字），适用于深色背景导航栏 -
"black"：强制深色文字（黑字），适用于浅色背景导航栏
为什么 iOS 上 style 不生效？
iOS 默认由系统统一管理状态栏样式，uni.setNavigationBarColor({ style: 'black' }) 会被无视，除非你提前在原生层关闭全局控制。
必须确认 Info.plist 中 UIViewControllerBasedStatusBarAppearance 设为 YES，否则 JS 层所有设置都无效。如果使用自定义基座，还要检查 AppDelegate.m 是否硬编码了 [UIApplication sharedApplication].statusBarStyle = UIStatusBarStyleDefault —— 这类代码会锁死状态栏样式。
另外，iOS 13+ 引入了 UIStatusBarStyleDarkContent（即“深色内容”），但 uni-app 封装层未暴露该枚举，仍只能走 "default"/"black" 二选一。
Android 端调用后不生效的典型原因
即使 JS 正确调用了 uni.setNavigationBarColor 并传了 style，很多安卓机型（尤其华为 EMUI、小米 MIUI）仍显示白色文字——根本原因是原生层没开启对应权限或配置。
- 必须配合
navigationBarBackgroundColor使用，单独设style大概率被忽略 - 需在
manifest.json → app-plus → android → permissions中添加"android.permission.WRITE_SETTINGS"（仅调试阶段，上线前必须移除） - 更稳妥方式：在
manifest.json中配置"statusBarStyle": "dark"，或引入 DCloud 官方statusBar插件 - 真机测试时，部分厂商会强制跟随系统深色模式，此时 JS 设置会被覆盖，需监听
uni.onOsThemeChange并重设
自定义导航栏（navigationStyle: "custom"）下 style 完全无效
一旦页面设为 "custom"，uni.setNavigationBarColor 就彻底失效——它只作用于原生导航栏。此时状态栏文字颜色不再受该 API 控制。
App 端正确做法是改用：plus.navigator.setStatusBarStyle("light") 或 "dark"（注意这里是字符串 "light"/"dark"，和 uni.setNavigationBarColor 的 "default"/"black" 不同）。
且必须放在 onReady 后执行，onLoad 阶段 plus 对象尚未就绪；同时要搭配 plus.navigator.getStatusBarHeight() 动态计算顶部安全区，否则文字可能被遮挡。
最常被忽略的一点：你在 pages.json 里写了 "navigationBarTextStyle": "white"，但页面用了 custom 导航栏——这个字段此时已被忽略，不会起任何作用。
