自定义导航栏文案必须用 vue 响应式（如{{$t()}}或usei18n().t()）实现，禁用pages.json占位符；app端需uni.relaunch强制重载页面才能更新；动态key需预枚举避免失焦；鸿蒙需flex+ellipsis适配字体溢出。
自定义导航栏的文案必须走 Vue 响应式，不能依赖 pages.json 的 %key% 占位符
pages.json 里的 navigationBarTitleText 和 tabBar.text 是原生层静态配置，只在冷启动时读取 locale/ 下的 JSON 文件。一旦你用 navigationStyle: "custom" 隐藏了原生导航栏，这部分就完全失效了——你写的 %index.title% 不会自动更新，也不会响应 i18n.locale 变更。
真正生效的方式是：在自定义导航栏组件里，用 {{$t('nav.title')}} 或 useI18n().t('nav.title') 动态渲染文字，并确保该组件被 Vue 实例完整管理（即不是 nvue 页面里硬写的原生 view）。
- 必须把导航栏写成标准
.vue组件（哪怕只是个NavBar.vue），挂载在页面顶部 - 不能在
onLoad里调用useI18n()—— 此时 i18n 实例还没 ready，会返回空对象 - 如果用了 Composition API，
t函数默认不监听 locale 变更，得配合watch(i18n.locale, () => {...})手动触发重渲染 - H5 和小程序端能靠
$t自动更新，但 App 端仍需页面重载才能让所有子组件（包括自定义导航栏）拿到新语言
切换语言时，自定义导航栏文字不更新？检查是否漏了页面重载
App 端没有热更新机制。即使你在自定义导航栏里写了 {{$t('back')}}，调用 i18n.locale.value = 'en-US' 后它也不会立刻变——Vue 的响应式系统虽然感知到了变化，但 App 的原生容器（比如 status bar 高度、字体渲染缓存）可能卡住旧状态。
唯一可靠的做法是：语言变更后，立刻执行 uni.reLaunch({ url: getCurrentPages()[0].route })，强制重建整个页面栈。
- 别用
redirectTo：路由栈残留会导致某些组件复用旧实例，$t还是返回中文 - 别只改
uni.setStorageSync('lang', 'en-US')就完事——storage 只管持久化，不管当前视图 - 重载前建议加个 loading 提示，避免用户误点多次触发重复请求
- 如果你的自定义导航栏里有异步加载的图标或 badge，重载时要重置其 loading 状态，否则可能出现“文字已切英文，但图标还在转圈”
多语言 key 设计要避开嵌套，尤其在自定义导航栏中
自定义导航栏常需要动态拼接文案，比如返回按钮文字、标题、右侧操作项（“编辑”“完成”“更多”）。这时候容易想当然写成 {{$t('navbar.' + action)}} 或 {{$t(`navbar.${type}`)}}，但要注意：vue-i18n 在 uni-app App 端对动态 key 支持不稳定，尤其当 key 字符串含变量时，首次渲染可能 fallback 到空字符串或默认语言。
更稳妥的方式是提前枚举好所有可能值，用计算属性或 map 映射：
const actionText = computed(() => ({
edit: $t('navbar.edit'),
done: $t('navbar.done'),
more: $t('navbar.more')
}[action.value] || $t('navbar.default')))
- 避免在模板里直接写
{{$t('navbar.' + someVar)}}，App 端容易失焦 - key 名统一用短横线分隔（
navbar-edit），不用驼峰或下划线，减少解析歧义 - 所有导航栏相关 key 必须在每个语言包里显式声明，漏一个就会显示 key 本身（如显示 “navbar-edit” 而非 “编辑”）
- 如果用了模块化语言包（按页面拆分），确保
navbar相关字段被 import 到主 messages 对象里，否则$t查不到
鸿蒙平台自定义导航栏要额外处理字体和布局适配
鸿蒙（HarmonyOS）对自定义导航栏的渲染逻辑和 Android/iOS 不同：它默认启用更激进的字体缩放策略，且部分设备会忽略 font-size 的 px 单位，导致多语言切换后文字溢出或截断（比如英文比中文长 30%，但容器没预留空间）。
解决方案不是换字体，而是从结构上预防：
- 导航栏容器用
flex+text-overflow: ellipsis，标题区域加min-width: 0触发 flex 自动收缩 - 所有文字类样式避免固定宽高，改用
padding和line-height控制垂直居中 - 鸿蒙下
uni.getSystemInfoSync().platform返回harmony，可据此加 class 适配：:class="{ 'harmony-nav': isHarmony }" - 不要在鸿蒙自定义导航栏里用
rich-text渲染多语言内容——它不支持$t响应式，只能预编译成纯文本再传入
