uni.setnavigationbartitle() 在 h5 端无效，需用 document.title；小程序端须在 onready 后调用；app 端需开启 titlenview 且注意 vue2/vue3 时机差异；跨平台应加类型判断并降级处理。
uni.setNavigationBarTitle() 为什么没生效
常见现象是调用 uni.setNavigationBarTitle() 后标题没变，尤其在页面刚加载时立即调用。根本原因是：H5 端不支持动态修改原生导航栏标题（它压根没原生导航栏），而小程序端要求页面必须已渲染完成、且不能在 onLoad 之前调用——但很多人写在 data 或 created 钩子中，此时 DOM 和原生导航栏都还没就绪。
实操建议：
- 只在
onReady或之后调用（onShow也可，但注意重复触发） - H5 端必须改用
document.title = 'xxx'，否则永远无效 - App 端（vue2）需确认
manifest.json中titleNView开启且未禁用导航栏；vue3 项目还需检查pages.json里对应页面的nvueStyle是否覆盖了标题设置 - 微信小程序真机调试时，若开启「调试基础库版本」过高（如 3.4+），部分低版本
setNavigationBarTitle会静默失败，建议降级到 3.2.x 测试
pages.json 里 titleNView 的配置陷阱
很多人以为只要写了 titleNView: { show: true } 就能自由控制标题，结果发现文字还是灰色、居左、无法加图标。问题出在：titleNView 是独立渲染层，它默认不读取页面 JS 设置的标题，也不响应 uni.setNavigationBarTitle() —— 它只认自己配置里的 text 或绑定的 autoBackButton 等字段。
实操建议：
- 若要用
titleNView实现动态标题，必须在pages.json中设"text": "{title}"，再通过uni.setStorageSync('title', '新标题')+ 页面 onShow 里this.$nextTick(() => uni.setNavigationBarTitle({title: xxx}))配合（仅 App 端有效） - 微信小程序不支持
titleNView，它走的是原生导航栏逻辑，所以pages.json里配了也无效 - 支付宝小程序要求
titleNView必须配合"type": "transparent"才能自定义样式，否则强制使用系统默认
跨平台统一改标题的最小安全写法
想一套代码跑全端，又不想每个平台写 if 判断？核心是区分“有原生导航栏”和“无”的环境，并让 H5 走 document.title，其他走 uni API。但要注意：App 端 vue3 的 onReady 触发时机比 vue2 晚，直接调用可能报错。
实操建议：
- 在
onReady里加防错：if (typeof uni.setNavigationBarTitle === 'function') {<br> uni.setNavigationBarTitle({ title: this.pageTitle });<br>} else {<br> document.title = this.pageTitle;<br>} - 避免在
mounted调用，vue3 的 mounted 可能早于页面原生层初始化 - 如果标题来自异步数据（比如接口返回），不要等接口完再 set，先设个 loading 文字，再用
uni.setNavigationBarTitle覆盖一次 - App 端冷启动时，首次页面跳转前的标题由
pages.json决定，JS 无法干预，这点容易被忽略
uni.navigateTo 传参改标题的常见误用
有人想在跳转时带个标题参数，然后在目标页直接读取并设标题，结果发现 options 里没拿到。这是因为 uni.navigateTo 的 url 参数不解析 query 里的中文或特殊字符，而且某些平台（如 QQ 小程序）会过滤掉非标准键名。
实操建议：
- 传参用标准 key：
uni.navigateTo({ url: '/pages/detail/detail?title=订单详情' })，目标页用decodeURIComponent(options.title)解码 - 避免传复杂对象，URL 长度限制严格（微信小程序最多 1024 字符）
- 更可靠的方式是跳转前用
uni.setStorageSync('tempPageTitle', 'xxx')，目标页onShow里读取并设置，用完立刻removeStorageSync - 注意：H5 端路由跳转后
document.title不会自动同步，仍需手动设
真正麻烦的不是怎么设标题，而是不同平台对“导航栏”的定义根本不同：H5 没这东西，小程序是系统控件，App 是自绘层。同一行代码，在三个平台可能走三条完全不同的底层路径。稍不注意，就变成“这里好了，那里崩了”。
