微信小程序原生仅支持light/dark状态栏文字色，uni-app的navigationBarTextStyle在navigationStyle: custom时失效；需手写导航栏并用CSS控制文字颜色，配合statusBarHeight适配安全区。

uni-app 微信小程序自定义状态栏文字颜色为什么无效？

因为微信小程序原生不支持直接修改状态栏文字颜色（仅支持 light / dark 两种模式），而 uni-app 的 navigationBarTextStyle 实际只是透传给微信的 navigationStyle: default 下的配置，**仅在页面级配置且未开启自定义导航栏时才生效**。一旦你用了 navigationStyle: custom（即隐藏原生导航栏、手写标题栏），navigationBarTextStyle 就完全失效。

如何让自定义导航栏里的文字显示为白色或黑色？

必须放弃依赖 navigationBarTextStyle，改用 CSS 控制你手写的标题区域文字颜色。常见做法是：在页面根节点上加 class，配合 statusBarHeight 做安全区适配，并手动设置文字颜色。

• 在 pages.json 中该页面配置设为："navigationStyle": "custom"
• 在页面 <template></template> 中，用 <view class="nav-bar"><text class="title">我的页面</text></view>
• 通过 uni.getSystemInfoSync().statusBarHeight 获取状态栏高度，在 onLoad 或 onShow 中赋值给 data，驱动样式
• CSS 中用 .title { color: #ffffff; }（深色背景配白字）或 #000000（浅色背景配黑字）

uni-app 在微信小程序里获取状态栏高度的坑

uni.getSystemInfoSync().statusBarHeight 在真机上返回正常，但在微信开发者工具中可能返回 0 或错误值（尤其旧版本工具）。更稳妥的方式是：优先读取 uni.getMenuButtonBoundingClientRect() 推算，或 fallback 到固定值 44px（iPhone X+ 系列典型值）。

微信公众号发文助手

微信公众号产业研究发文助手，支持原文读取、分层摘要、产业链标的梳理、image2 海报与封面生成、正文排版、微信草稿保存、回读校验和发布前确认。

下载

• uni.getMenuButtonBoundingClientRect() 返回对象含 top 和 height，状态栏高度 ≈ top - statusBarHeight（需结合机型判断）
• 简单项目可直接设 statusBarHeight: 44，并用 @supports (padding-top: env(safe-area-inset-top)) 做兼容
• 不要在 created 钩子中调用，微信小程序生命周期里此时 uni API 可能未就绪，建议放 onLoad

标题文字颜色随系统主题自动切换怎么做？

微信小程序本身不提供「深色模式下自动翻转文字色」的 API，uni-app 也没有封装该能力。如需跟随系统，只能手动监听并判断：

• 调用 wx.onThemeChange（基础库 2.11.0+ 支持），在回调中更新 titleColor data
• 首次进入时用 wx.getSystemInfoSync().theme 获取当前主题（返回 light 或 dark）
• 注意：H5 和 App 端无此 API，需条件编译隔离，例如：

  #ifdef MP-WEIXIN
  wx.onThemeChange && wx.onThemeChange(res => {
    this.titleColor = res.theme === 'dark' ? '#ffffff' : '#000000'
  })
  #endif

微信小程序的“状态栏文字颜色”本质是系统级控制，uni-app 能做的只是模拟视觉效果；真正要稳定呈现，得靠自己画标题栏 + 主动管理颜色 + 安全区适配。别指望配置项一键生效。