uni-app状态栏文字颜色无法纯前端控制，需按平台差异处理：App端用plus.navigator.setStatusBarStyle且onReady后调用；小程序需custom导航栏+pages.json配置；H5不可控。
uni-app状态栏文字颜色不随主题切换？先看 platform 行为差异
状态栏文字颜色（白色/黑色）在 uni-app 中根本不是纯前端可控的，它由平台原生层决定，且各端逻辑完全不同：
-
App端：必须调用plus.navigator.setStatusBarStyle，且只接受"light"或"dark"字符串；onLoad里调用大概率失效，得等onReady后再执行 -
微信小程序：若使用自定义导航栏（navigationStyle: "custom"），navigationBarTextStyle在页面级style配置中才生效，且仅对mp-weixin有效；全局app.json的navigationStyle必须也是"custom"，否则子页配置被忽略 -
H5：完全不可控，浏览器不提供 API；所有“模拟”都是用 padding + 背景色障眼法，状态栏本身仍是系统默认样式
最常踩的坑是：写了 custom 导航栏，却还在 pages.json 里改 navigationBarTextStyle，以为能起效——它此时已被跳过。
pages.json 中的 @navTextStyle 为什么没反应
@navTextStyle 是 theme.json 注入变量，但它只在以下条件下生效：
- manifest.json 中对应平台（如
mp-weixin、app-plus）必须显式配置：{"darkmode": true, "themeLocation": "theme.json"} -
theme.json必须放在项目根目录，编码为 UTF-8 无 BOM，内容只能有light和dark两级，例如：{"light": {"navTextStyle": "black"}, "dark": {"navTextStyle": "white"}} - 页面不能是
nvue（nvue 不支持 @ 变量注入） - 该变量仅用于
navigationBarTextStyle字段，不能用在组件 style 或 CSS 中
如果你改了本地存储的 theme 值但导航栏没变，不是代码错，是因为 pages.json 是编译期注入，运行时修改需强制重载页面：uni.reLaunch({ url: '/pages/index/index' })。
App 端动态切换状态栏样式的正确时机与写法
uni.setNavigationBarColor 不能控制文字颜色，那是 style 参数的事。真正要调的是：
-
plus.navigator.setStatusBarStyle('light')→ 状态栏文字变黑（背景亮时用） -
plus.navigator.setStatusBarStyle('dark')→ 状态栏文字变白（背景暗时用）
但要注意：
- 必须在
onReady生命周期之后调用，onLoad里plus对象可能未就绪 - Android 需确保
AndroidManifest.xml中启用android:windowLightStatusBar="true"（深色背景时显示浅色文字） - iOS 需确认
Info.plist中UIViewControllerBasedStatusBarAppearance为YES，否则 JS 设置被系统接管 - 小米/华为等厂商 ROM 可能强制跟随系统深色模式，此时需监听系统变化并重设：
uni.onThemeChange+ 再次调用plus.navigator.setStatusBarStyle
小程序里如何让状态栏随用户主题切换实时响应
微信小程序不支持 window.matchMedia，也不能靠 onThemeChange 实时捕获（基础库低版本返回快照值）。可靠做法是：
- 用户点击切换按钮时，立即执行：
uni.setStorageSync('theme', 'dark') - 在当前页面
onShow中读取并触发重绘：const theme = uni.getStorageSync('theme') || 'light';<br>if (theme !== this.currentTheme) {<br> this.currentTheme = theme;<br> uni.$emit('themeChanged', theme);<br>} - App.vue 中监听
themeChanged，用uni.reLaunch刷新当前页（避免 custom 导航栏卡在旧样式） - 若使用原生插件（如 statusBar 插件），需在 manifest.json 中配置
"statusBarStyle": "auto"，并确保插件已启用
最易被忽略的一点：iOS 真机上，即使你 JS 层调用了 setStatusBarStyle，如果原生工程中 AppDelegate.m 有硬编码 [UIApplication sharedApplication].statusBarStyle = UIStatusBarStyleDefault，那一切设置都会被覆盖。
