uni.getSystemInfo 返回的语言不准确,因其依赖宿主环境(如微信客户端语言、浏览器 language)而非系统设置;推荐优先使用 uni.getLocale() 并注意初始化时机、平台差异及资源文件名严格匹配。

uni.getSystemInfo 为什么有时拿不到准确系统语言
它返回的是宿主环境的语言标识,但不是所有平台都严格按系统设置走。比如微信小程序里 uni.getSystemInfo 返回的 language 字段其实是微信客户端语言,不是手机系统语言;H5 环境下可能取自浏览器 navigator.language;而 App(5+)环境下更推荐用 plus.os.language,但必须等 plusready 事件触发后才能安全调用。
常见错误现象:
- 在 H5 或小程序里调用
uni.getSystemInfo得到zh,但用户手机设的是zh-Hant(繁体),结果加载了简体包却显示乱码 - App 打包后首次启动语言正确,杀进程重进就“回退”成英文——因为没持久化记录,也没监听语言变更
实操建议:
- 优先用
uni.getLocale(),它是 uni-app 官方封装的统一入口,会自动 fallback 到系统级语言(App/H5/小程序均支持) - 若需更高精度(如区分简繁),搭配
uni.getSystemInfoSync().hostLanguage(小程序)或plus.os.language(App)做二次校验 - 别在
onLaunch里直接同步 require 多语言 JSON,容易因异步时机导致页面渲染时$t还没就绪
vue-i18n 初始化阶段怎么自动匹配系统语言
关键不在“获取”,而在“设置时机”——locale 必须在 Vue 实例创建前确定,否则后续组件里的 $t 会默认用初始 locale 渲染,改了也白改。
实操建议:
- 在
main.js(或main.ts)最顶部同步读取语言:const locale = uni.getLocale() || 'zh-CN'
- 不要写成
locale: uni.getLocale()直接传给createI18n,某些平台(如旧版 H5)uni.getLocale可能异步延迟,导致初始化为空字符串 - 如果项目用了条件编译(如仅 App 需要繁体支持),记得在
messages里显式声明键名,例如'zh-Hant': zhHant,否则uni.getLocale()返回zh-Hant时会 fallback 到默认语言
App 启动时语言切换为啥要重启?怎么绕过
Android 平台下,调用 uni.setLocale('en-US') 会触发应用重启,这是 5+ Runtime 的硬性限制,不是 bug。iOS 和小程序则无此行为。
这意味着:你不能在用户点“切换语言”按钮后,指望当前页面立刻刷新翻译——它会闪退再进一次。
实操建议:
- 首次启动自动适配时,**别调
uni.setLocale**,直接用uni.getLocale()结果初始化 i18n,避免无谓重启 - 手动切换场景下,如果不想重启,可改用纯前端方案:把多语言 JSON 挂到全局(如
getApp().globalData.lang),模板里用{{$app.globalData.lang.xxx}},但会丢失$t的插值、复数、日期格式等高级能力 - 真要兼顾体验和功能?提前在
manifest.json的 “SDK 配置” 里勾选“国际化支持”,确保打包时注入对应语言资源,减少运行时 fallback
小程序里 uni.getLocale() 返回值不准怎么办
小程序平台(尤其微信)的 uni.getLocale() 本质是取微信客户端语言,和手机系统语言无关。如果你发现用户手机设了日语,但 uni.getLocale() 还是 zh-CN,大概率是微信 App 自身语言没切。
实操建议:
- 调试时先确认微信客户端设置:我 → 设置 → 通用 → 语言 —— 这里才是真实影响
uni.getLocale()的源头 - 不依赖它做关键逻辑,比如权限弹窗文案。系统级弹窗(如定位、相机)的提示语由微信/支付宝原生控制,前端 i18n 无效,得靠平台侧配置(如微信小程序后台的「多语言支持」开关 + 对应 JSON 上传)
- 需要强绑定系统语言?小程序做不到。只能引导用户去微信内设置,或降级使用
uni.getSystemInfoSync().system+ 正则粗判(如system.includes('iOS')),但精度极低
最易被忽略的一点:语言资源文件名必须和 uni.getLocale() 返回值完全一致(包括大小写和连字符),zh-Hans 和 zh-HANS 是两个不同 key,漏配就会静默 fallback。











