navigationstyle: "custom" 必须配置在 pages.json 的页面级 style 对象内，globalstyle 不生效；h5 端禁用 var(--status-bar-height)；小程序需用 env.safearea.top；app 端 web-view 需手动设置 top 和 height。
navigationStyle: "custom" 在 pages.json 里没生效
最常见的情况是配置写错了位置。navigationStyle 必须放在页面级 style 对象里，不能只写在 globalStyle 中——后者只控制默认行为，一旦某个页面没显式声明，就会回退到系统原生导航栏。
检查你的 pages.json，确保类似这样：
{
"pages": [
{
"path": "pages/home/index",
"style": {
"navigationStyle": "custom"
}
}
]
}
如果整个项目都要自定义，也要逐个页面配，globalStyle 不接管 navigationStyle 的继承逻辑。
容易踩的坑：
- 复制粘贴时漏掉外层
style，直接把navigationStyle写进pages数组项里 - 路径拼错（比如写成
page/home/index而不是pages/home/index），导致该配置根本没被加载 - 改完没重启 HBuilderX 或没清
unpackage目录，旧缓存还在用
H5 端自定义导航栏高度写 var(--status-bar-height) 导致贴顶或截断
H5 没有状态栏，--status-bar-height 编译后就是 0px。你写了 top: var(--status-bar-height) 或 padding-top: calc(var(--status-bar-height) + 44px)，结果就是导航栏直接顶到视口顶部，内容被遮住。
正确做法是彻底区分平台：
- // #ifdef H5
height: 44px; top: 0;
// #endif - // #ifdef APP-PLUS
padding-top: calc(var(--status-bar-height) + 44px);
// #endif - 绝不要在 H5 条件下读
uni.getSystemInfoSync().statusBarHeight，它返回0或undefined
UI 库如 uView 的 uv-navbar 默认开启 placeholder，H5 下会额外加一层空白，记得关掉：:placeholder="false"。
小程序端导航栏高度计算不准，刘海屏下偏移
直接用 statusBarHeight 加固定值（比如 +44）在 iOS 15+ 或华为/小米刘海机上大概率出错。真实安全区顶部边界得靠 env.safeArea.top，它在小程序环境 onLoad 后才可用。
实操建议：
- 不要在
created或mounted里取值，必须等onLoad触发后再访问uni.getEnv()或直接读env.safeArea.top - fallback 逻辑要写全：优先
env.safeArea.top，不存在再用statusBarHeight，H5 则固定44 - 胶囊按钮位置要用
wx.getMenuButtonBoundingClientRect()（微信）或my.getMenuButtonBoundingClientRect()（支付宝），不能硬编码
示例片段（微信小程序）：
onLoad() {
const { safeArea } = uni.getEnv() || {};
this.navTop = safeArea?.top || uni.getSystemInfoSync().statusBarHeight;
}
App 端 web-view 嵌套 H5 时原生导航栏高度干扰
如果你用 web-view 把外部 H5 套进 uni-app App 容器里，navigationStyle: "custom" 关的是 uni-app 自己的原生导航栏，但 web-view 本身仍会受容器高度影响——尤其当没手动设置 web-view 的 top 和 height 时，它可能从 y=0 开始渲染，把内容顶到状态栏下面。
解决方法是主动控制 web-view 的布局：
- 在页面
onReady后获取当前 webview 实例：this.$scope.$getAppWebview() - 用
children()[0].setStyle({ top: 44, height: 'calc(100% - 44px)' })显式定位（注意单位是 px） - 延迟执行（如
setTimeout(..., 300)），确保 webview 子实例已挂载
这个逻辑只对 App 端有效，H5 和小程序里 web-view 行为完全不同，必须用条件编译隔离。
真正麻烦的从来不是“怎么设高度”，而是同一套代码在三端运行时，每个平台对“高度”的定义根本不同：H5 是纯视觉约定，小程序依赖容器注入的 env，App 端又混着原生层和 WebView 层。不切开逻辑，迟早被某台 iPhone 或某版微信悄悄搞崩。
