app端导航栏无法真正透明，需关闭原生导航栏并自定义实现；小程序端需同时传入不透明的frontcolor和backgroundcolor；h5端不支持该api。
uni.setNavigationBarColor 在 APP 端设 backgroundColor 为透明值（如 "#00000000" 或 "transparent"）基本无效——这不是你代码写错了，是原生层不接受透明背景色。状态栏背景只能是不透明颜色，所谓“透明”，本质是交出控制权后由页面自己模拟。
APP 端：关闭原生导航栏 + 手动占位才是真透明
启用 "navigationStyle": "custom" 后，状态栏区域变成“窗口”，但不会自动透明。必须靠页面自己画出来：
- 在
pages.json对应页面加"navigationStyle": "custom" - 页面根容器（如最外层
<view></view>）加padding-top: var(--status-bar-height)，不是固定20px - 顶部导航栏容器（如
<view class="nav"></view>）设background-color: transparent，且不能有box-shadow、border或半透叠加 - 若用
<uni-nav-bar></uni-nav-bar>，必须显式绑定:background-color="transparent" -
--status-bar-height是 uni-app 注入的 CSS 变量，只在custom模式下可用，iOS/Android 已适配，别用uni.getSystemInfoSync().statusBarHeight硬编码
小程序端：不能设透明，必须同时传两个颜色
微信/支付宝小程序支持 uni.setNavigationBarColor，但 frontColor 和 backgroundColor 必须同时传，缺一不可。传 "transparent" 或带 alpha 的十六进制（如 "#00000000"）会被忽略，回退为系统默认色：
- 正确写法：
uni.setNavigationBarColor({ frontColor: '#ffffff', backgroundColor: '#1e40af' }) - 错误写法：
backgroundColor: 'transparent'、backgroundColor: '#00000000'、只传frontColor - 页面级配置优先于全局，但运行时无法动态切换
navigationStyle，所以透明效果只能靠自定义导航栏实现
H5 端：根本没法改状态栏，别调 API
H5 调用 uni.setNavigationBarColor 必然报错 undefined is not a function。浏览器不提供该能力，iOS Safari 尤其严格：
- 删掉所有 H5 平台下的
uni.setNavigationBarColor调用 - 用
<view class="status-bar-placeholder"></view>占位，高度硬编码为20px（iOS 标准）或用env(safe-area-inset-top)（仅 Safari 支持） -
<meta name="theme-color" content="#1e40af">只影响地址栏，需在onShow中手动更新，SPA 切页不会自动刷新 -
viewport必须含viewport-fit=cover，否则安全区逻辑错乱
最容易被忽略的是：APP 端 custom 模式下，状态栏文字颜色完全不受 uni.setNavigationBarColor 控制；iOS 必须单独调 uni.setStatusBarStyle('light') 或 'dark'，Android 则依赖 frontColor 推断，二者行为不一致。
