uni.setNavigationBarTitle()在H5端无效需用document.title，小程序端须onLoad后调用且禁用custom导航，App端受titleNView和Vue版本时机影响；最常见失效原因是生命周期错位、启用custom或平台不支持。
uni.setnavigationbartitle() 在 h5 端完全无效，必须用 document.title；小程序端必须在 onload 或之后调用，且不能启用 navigationstyle: "custom"；app 端还受 titlenview 配置和 vue 版本时机影响——不区分平台硬写一行 api，标题大概率不显示。
为什么 uni.setNavigationBarTitle() 调了没反应
最常见原因是生命周期时机错位或环境不支持：
- 写在
data、created或onLoad之前：此时页面原生导航栏还没初始化，API 直接静默失败 - 写在
onShow里：iOS 和部分安卓机型会忽略，因为导航栏结构已渲染完成，不支持重绘 - pages.json 中该页面启用了
"navigationStyle": "custom"：原生导航栏被移除，uni.setNavigationBarTitle()失去作用对象 - H5 平台下该 API 仅等价于
document.title = xxx，不会影响页面内任何 UI 元素
各平台正确调用时机与写法
不能一套代码通吃，得按平台特性分治：
- 微信/支付宝/百度等小程序：只在
onLoad或onReady中调用，推荐onLoad（能直接取到options，适合参数驱动标题） - App 端（Vue2）：确保
manifest.json开启titleNView，且未禁用导航栏；Vue3 项目需注意onReady触发更晚，可加setTimeout(() => uni.setNavigationBarTitle(...), 50)避免报错 - H5 平台：必须用
document.title = 'xxx'，条件编译写法是：// #ifdef H5→document.title = 'xxx'→// #endif - nvue 页面：该 API 完全不支持，只能自己用
<view></view>实现标题栏
标题内容清洗与长度控制
传参看似简单，但中文乱码、截断、闪退常源于字符串脏数据：
- 务必先清洗：用
title.trim().replace(/\s+/g, ' ')去掉零宽空格、BOM、连续空格 - 长度限制按 UTF-16 单位算：中文占 2，建议 ≤12 字；Android 厂商系统常在 14~16 字就强制截断，且无回调、不可干预
- 避免后端字段直拼标题，尤其含用户昵称时，需过滤控制字符（如
\u200b、\ufeff），别依赖encodeURIComponent解决显示问题 - 异步场景（如请求后设标题）：
onLoad里先设“加载中”，再在then中更新真实标题，防止白屏期间标题为空
跨平台统一处理的最小安全写法
不推荐封装成一个函数全局调用，容易掩盖平台差异。真正安全的做法是明确分支：
- 静态标题优先走
pages.json的navigationBarTitleText，动态仅用于少数必要场景 - 若必须动态，每个页面在
onLoad中按平台判断：if (uni.getSystemInfoSync().platform === 'h5')→document.title，否则调uni.setNavigationBarTitle - 微信小程序真机调试时，基础库 ≥3.4 可能静默失败，建议临时降级到 3.2.x 测试
- 支付宝小程序若用
titleNView，必须配"type": "transparent"才能生效，否则样式被强制覆盖
真正容易被忽略的是：页面 A 跳转到 B 后，B 的标题要根据 A 传来的 options 动态生成，但很多人漏掉了 onLoad(options) 的参数解构，或者把清洗逻辑放在了 onShow 导致重复执行或时机错误。
