navigationbartextstyle: "white" 仅在 navigationstyle 为 "default" 且运行于 app 或微信小程序时可能生效；设为 "custom" 后该配置被忽略，状态栏文字颜色需通过 css 控制标题颜色实现。
直接改 navigationBarTextStyle 为 "white" 只在特定条件下生效，多数情况下它根本不起作用——尤其你用了自定义导航栏或在 H5 环境下。
navigationStyle 是 "default" 还是 "custom"？
这是最关键的分水岭：
- 设为
"default"：页面保留原生导航栏，navigationBarTextStyle: "white"才可能生效（仅限 App 和微信小程序端） - 设为
"custom"：原生导航栏和状态栏控制权完全交还给页面，navigationBarTextStyle被忽略，此时“状态栏字体颜色”实际是你手写标题区域的color值 - H5 端无论哪种模式，都无法真正修改状态栏文字颜色——浏览器不提供该能力，所有“白色”都是视觉模拟
App 端调用 plus.navigator.setStatusBarStyle("light")
即使你写了 navigationBarTextStyle: "white"，App 端仍需主动调用原生 API 才能真正让状态栏文字变白：
- 必须在
onReady生命周期中调用，onLoad太早，plus对象未就绪 - 参数只能是
"light"（白字）或"dark"（黑字），不是十六进制色值 - iOS 需确保
Info.plist中UIViewControllerBasedStatusBarAppearance设为YES，否则 JS 调用无效 - Android 部分机型（如 MIUI、EMUI）会强制跟随系统深色模式，JS 设置可能被覆盖，需监听系统主题变化并重设
微信小程序里自定义导航栏怎么让标题显白色
你写的 <text>标题</text> 就是“状态栏区域的文字”，它的颜色由 CSS 决定，和 navigationBarTextStyle 无关：
- 先在
pages.json中确认该页面已配置"navigationStyle": "custom" - 在页面
onLoad或onShow中获取高度：this.statusBarHeight = uni.getSystemInfoSync().statusBarHeight - 模板中用
<view class="nav-bar" :style="{ paddingTop: statusBarHeight + 'px' }"><text class="title">我的页面</text></view> - CSS 中写
.title { color: #ffffff; }—— 白色是否可见，取决于你导航栏背景是不是深色 - 真机测试时，若
uni.getSystemInfoSync().statusBarHeight返回 0，可 fallback 到44（iPhone X+ 典型值）或用uni.getMenuButtonBoundingClientRect()推算
uni.setNavigationBarColor({ frontColor: '#ffffff' }) 为什么没反应
这个 API 根本不控制“状态栏字体颜色”，它只影响导航栏本身的前景色（比如返回箭头、菜单图标），且行为平台差异极大：
- 微信小程序：必须同时传
frontColor和backgroundColor，缺一不可；frontColor实际只控制图标/文字颜色，不是状态栏字体 - App 端（uni-app x）：该 API 的
background参数已失效，只支持frontColor，且仅作用于原生导航栏区域，不影响状态栏 - H5 端：调用即报错或静默失败，别试
- 如果你想要状态栏区域显示白色文字，唯一可靠路径是：自定义导航栏 + CSS 控制标题颜色 + 正确适配
statusBarHeight
最常被忽略的一点：你以为在 pages.json 里写了 "navigationBarTextStyle": "white" 就万事大吉，但只要启用了 "custom"，这行配置就形同虚设——你得亲手把文字画出来，再亲手把它染白。
