App端状态栏文字颜色需原生控制，uni.setNavigationBarColor仅改导航栏背景色；style参数仅App端生效，取值"default"/"black"，须配合navigationBarBackgroundColor且延迟调用；Android需配置权限及windowLightStatusBar，iOS需启用UIViewControllerBasedStatusBarAppearance。
App端无法通过CSS或JS动态修改状态栏文字颜色，必须调用原生能力；uni-app提供的 setBackgroundColor 和 setStyle 仅支持部分平台，iOS和Android行为差异大，直接写死配置或监听系统主题会失效。
uni.setNavigationBarColor 不等于状态栏文字颜色控制
很多人误以为 uni.setNavigationBarColor 能改状态栏文字（如白色/黑色），其实它只影响导航栏背景色。状态栏文字颜色由 style 参数单独控制，且仅在 App 端生效，H5 和小程序完全不支持该字段。
-
style只接受"default"（浅色文字）、"black"（深色文字）两个值，iOS 13+ 和 Android 6.0+ 才识别 - 调用后不会立即生效，需配合
navigationBarBackgroundColor使用，否则部分安卓机型（如华为EMUI）会忽略 - 不能在
onLoad中立刻调用，建议延迟 100ms 或放在onReady后执行
Android端需额外配置 android:windowLightStatusBar
即使 JS 调用了 uni.setNavigationBarColor({ style: 'black' })，若未在原生层开启对应权限，状态栏文字仍为白色（不可见）。需要手动修改 AndroidManifest.xml 或使用自定义基座：
- 在
manifest.json → app-plus → android → permissions下添加："android.permission.WRITE_SETTINGS"（仅调试用，上线需移除） - 更稳妥的方式：在
nativePlugins中引入原生插件，或使用 DCloud 官方推荐的statusBar插件（需在manifest.json中配置"statusBarStyle": "dark"） - 真机测试时，部分厂商（如小米MIUI）会强制跟随系统深色模式，此时 JS 设置会被覆盖，需监听系统变化并重设
iOS端必须启用 UIViewControllerBasedStatusBarAppearance
iOS 默认由系统统一管理状态栏样式，uni-app 的 JS 调用无效，除非在原生工程中关闭全局控制：
- 打开
unpackage/res/android/AndroidManifest.xml（Android）或 Xcode 工程中的Info.plist（iOS） - iOS 需确保
UIViewControllerBasedStatusBarAppearance设为YES，否则style参数被忽略 - 如果使用自定义基座，还需检查
AppDelegate.m是否调用了[UIApplication sharedApplication].statusBarStyle = UIStatusBarStyleDefault;—— 这类硬编码会锁死样式 - 注意：iOS 13+ 引入了
overrideUserInterfaceStyle，但 uni-app 尚未封装该 API，无法响应系统级深色模式切换
真正可靠的方案是：App 启动时读取系统偏好（plus.navigator.getStatusBarStyle()），再结合业务逻辑决定初始 style；后续切换主题时，先调用 uni.setNavigationBarColor，再触发原生层重新渲染——这步在部分安卓机型上不可省略。
