uni.setnavigationbarcolor 的 style 参数必须显式传 "black"：仅 app 端生效，只接受 "default" 或 "black"，需配合 navigationbarbackgroundcolor 使用，且 android 需开启 windowlightstatusbar，ios 需配置 uiviewcontrollerbasedstatusbarappearance 为 yes，小程序则依赖 pages.json 中 navigationbartextstyle。
uni.setNavigationBarColor 的 style 参数必须显式传 "black"
很多人调用 uni.setNavigationBarColor 时只改了 navigationBarBackgroundColor，却漏掉 style 字段——这个字段才是控制文字颜色的唯一开关，且仅 App 端生效。
它不接受 CSS 颜色值（如 "#000000"），只认两个字符串："default"（浅色文字，通常为黑）和 "black"（深色文字，强制黑）。注意："black" 在部分 Android 厂商系统（如 MIUI、EMUI）下实际表现是“深色前景”，即文字变黑；而 "default" 可能随系统主题浮动，不可控。
- 必须同时传
navigationBarBackgroundColor和style，否则某些安卓机型（尤其是华为）会忽略style - 不能在
onLoad立即调用，建议延迟100ms 或放在onReady后执行 - H5 和小程序平台完全无视
style字段，此处设置无效
Android 端需检查原生层是否启用 windowLightStatusBar
即使 JS 层调用了 uni.setNavigationBarColor({ style: 'black' })，若原生配置未开启浅色状态栏支持，文字仍会是白色（尤其在深色背景上不可见）。
关键点在于 AndroidManifest.xml 中对应 Activity 的 theme 是否设置了 android:windowLightStatusBar="true"。DCloud 默认基座未开启此选项，自定义基座或真机调试时容易遗漏。
- manifest.json → app-plus → android → 无法直接配该属性，需手动修改原生工程或使用插件
- 更稳妥做法：在
nativePlugins中引入官方statusBar插件，并在 manifest.json 中声明"statusBarStyle": "dark" - 上线包禁止添加
WRITE_SETTINGS权限，仅调试阶段可用
iOS 端必须关闭全局状态栏控制
iOS 默认由系统统一管理状态栏样式，uni.setNavigationBarColor 的 style 参数会被静默忽略，除非你确认原生层已关闭 UIViewControllerBasedStatusBarAppearance 的全局接管。
检查路径：unpackage/res/ios/Info.plist，确保存在键 UIViewControllerBasedStatusBarAppearance 且值为 YES；若为 NO，则整个 App 的状态栏样式被锁死，JS 调用全部失效。
- 使用自定义基座时，还需检查
AppDelegate.m是否硬编码了[UIApplication sharedApplication].statusBarStyle = UIStatusBarStyleDefault，这类代码会覆盖所有 JS 设置 - iOS 13+ 的
overrideUserInterfaceStyle未被 uni-app 封装，无法响应系统深色模式切换，只能固定设为"black"
微信小程序里 navigationBarTextStyle 是唯一有效途径
小程序平台不支持 uni.setNavigationBarColor 的 style，但只要没设 navigationStyle: "custom"，navigationBarTextStyle: "black" 就能生效。
注意：一旦页面启用了自定义导航栏，该字段即失效——此时状态栏文字颜色由系统根据顶部区域背景明暗自动判断，JS 无权干预。所以“强制黑色”的前提是你仍在用默认导航栏。
- pages.json 中对应页面的 style 下必须写
"navigationBarTextStyle": "black"（值只能是"black"或"white"） - 不要在条件编译里混用，例如
#ifdef MP-WEIXIN包裹该配置是多余的，pages.json 本身按平台解析 - 真机测试时，部分 iOS 微信版本可能缓存旧样式，需杀进程重进
最易被忽略的是平台行为割裂：App 端靠原生能力 + JS 调用协同，小程序靠 pages.json 静态配置，H5 则完全不可控。同一套逻辑无法跨端复用，必须分平台处理，且每个平台都有其不可绕过的原生约束点。
