uni-app中状态栏文字颜色需按平台分别处理：App端用plus.navigator.setStatusBarStyle，小程序调用对应API，H5不可控；自定义导航栏时navigationBarTextStyle无效，须原生桥接或条件编译。
uni-app里怎么让状态栏文字变成白色或黑色
状态栏文字颜色由 navigationStyle 和平台原生能力共同决定，不能仅靠 CSS 控制。iOS 和 Android 行为不一致，直接改 navigationBarTextStyle 可能无效——尤其在自定义导航栏场景下。
关键点：只有启用默认导航栏（navigationStyle: "default"）时，navigationBarTextStyle 才生效；一旦设为 "custom"，状态栏文字颜色就脱离 H5/小程序控制逻辑，需通过原生层或条件式透传配置。
- iOS：依赖
info.plist中的UIStatusBarStyle（全局），或在页面生命周期中调用原生 API（需插件或条件编译） - Android：部分厂商（如华为、小米）会强制跟随系统深色模式，
navigationBarTextStyle仅对微信小程序、App 端部分版本有效 - H5：完全不可控，浏览器不暴露该接口，所有“修改”都是伪实现（比如用 padding 模拟，但实际状态栏仍是系统默认）
自定义导航栏后状态栏文字颜色不随主题切换怎么办
这是最常被忽略的坑：你写了 custom 导航栏，却还指望 navigationBarTextStyle 起作用——它此时已被忽略。真正起效的是页面级的 style 配置或条件编译下的原生桥接。
实操建议：
- 在
pages.json中为该页面单独设置：{"style": {"navigationStyle": "custom", "navigationBarTextStyle": "white"}}—— 注意：这个字段只在 App 和微信小程序端对自定义导航栏生效（H5 无视） - App 端需配合
plus.navigator.setStatusBarStyle("light")或"dark"主动设置，且必须在onReady后调用（onLoad太早，plus 对象未就绪） - 微信小程序端若使用
custom，需确保app.json中navigationStyle是"custom"，否则子页面配置不继承
uni-app里动态切换状态栏文字颜色的正确姿势
不能靠响应式 data 绑定 navigationBarTextStyle，它不是响应式字段。动态切换必须走原生 API 或重新触发页面样式重载。
推荐方案：
- App 端：用
plus.navigator.setStatusBarStyle("light")+plus.navigator.getStatusBarHeight()获取高度做适配 - 微信小程序：调用
wx.setNavigationBarColor({ frontColor: "#ffffff" })（注意是frontColor，值必须是"#000000"或"#ffffff"） - 支付宝小程序：用
my.setNavigationBarColor({ textColor: "white" }) - 统一写法可封装成条件编译：
#ifdef APP-PLUS<br> plus.navigator.setStatusBarStyle(isDark ? "dark" : "light");<br>#endif<br>#ifdef MP-WEIXIN<br> wx.setNavigationBarColor({ frontColor: isDark ? "#ffffff" : "#000000" });<br>#endif
为什么真机调试时状态栏颜色偶尔失效
常见于冷启动、页面跳转过快、或未等 plus 初始化完成就调用 API。错误现象包括：首次打开是黑字，返回再进变白字；或深色模式下始终显示为浅色。
排查重点：
- 检查是否在
onReady或onShow中调用原生 API，而非onLoad - App 端确认
manifest.json → 模块权限 → Statusbar已勾选 - 微信小程序确认基础库版本 ≥ 2.7.0（
setNavigationBarColor最低要求） - 避免在 TabBar 页面中频繁切换状态栏样式——部分平台会缓存上一个页面的设置
最隐蔽的问题：iOS 上如果应用未声明支持深色模式（Info.plist 缺少 UIUserInterfaceStyle），系统可能强制 fallback 到浅色状态栏，导致 setStatusBarStyle 被忽略。
