android多语言需严格遵循bcp 47标准路径(如values-zh-rcn),用as向导创建;strings.xml中格式字符串用cdata+gettext(),复数需先getquantitystring再string.format;动态换语言须recreate()或appcompatdelegate.setapplicationlocales()。

strings.xml 里怎么写多语言字符串才不被系统忽略
Android 只认 res/values-xx/strings.xml 这种路径结构,放错目录等于没写。比如把中文繁体资源放在 res/values-zh-Hant/ 是对的,但写成 res/values-zh-TW/(虽然某些旧设备能 fallback)——在 Android 12+ 上可能直接不加载。
常见错误现象:getString(R.string.xxx) 返回空字符串或默认语言内容,debug 时发现 Configuration.getLocales().get(0) 显示的是 zh-CN,但 app 却没走 values-zh-rCN 目录。
- 必须用 BCP 47 标准命名:简体中文是
values-zh-rCN,繁体中文是values-zh-rTW或values-zh-rHK;values-zh-Hans和values-zh-Hant是兼容写法,但仅限 Android 7.0+,低版本会 fallback 到values - 不要手动拼接 locale 字符串去创建目录名,用 Android Studio 的 “New → Values resource file” 向导选语言和地区,它会自动生成合规路径
- 所有语言版本的
strings.xml必须有完全一致的name属性值,缺一个 key,运行时就用默认values/strings.xml里的,不会报错也不会警告
带格式的字符串(如 HTML 标签)在多语言中怎么安全转义
直接写 <b>重要</b> 在 strings.xml 里会导致 getText() 渲染出原始标签,而 getString() 又会把 < 当普通文本——这不是 bug,是设计如此。
使用场景:按钮文字含强调词、提示语带换行或颜色标记。
- 需要保留格式时,统一用
CDATA包裹:<string name="hint"><![CDATA[请<strong>立即</strong>检查 <br/>网络连接]]></string>
然后在代码里用getText(R.string.hint)(不是getString) - 如果必须用
getString()(比如传给第三方 SDK),就得手动转义:写成<b>重要</b>,再用Html.fromHtml(str, Html.FROM_HTML_MODE_COMPACT)解析(注意 API 24+ 参数不同) - 别在
CDATA里写未转义的双引号或单引号,否则 XML 解析失败;像"点击这里"应写成"点击这里"
复数字符串(plurals)和带占位符的字符串混用时的坑
<plurals></plurals> 本身不支持 %1$s 这类占位符,硬写进去会导致运行时报 IllegalArgumentException: can't find beginning of tag 或静默 fallback 到 other。
性能影响:每次调用 getQuantityString() 都要解析整个 <plurals></plurals> 块,如果还嵌套了复杂逻辑,比纯 getString() 慢 2–3 倍(实测 Nexus 5X 上平均高 0.8ms)。
- 正确做法是先用
getQuantityString(R.plurals.xxx, count)拿到模板字符串(如%d 个文件已删除),再用String.format()填充变量 - 如果变量本身也要翻译(比如单位“GB”在不同语言里缩写不同),那就不能依赖
String.format(),得拆成两个 string:一个 plural 模板(不含单位),一个单位字符串(单独定义并翻译) - 注意
count参数必须是非负整数,传负数会强制 fallback 到other,且不报错
动态切换语言后 strings.xml 不刷新的典型原因
调用 Resources.getSystem().getConfiguration().setLocale() 没用,这是系统资源,不是你 app 的。真正生效要重建 Activity,而且必须确保 Application 或 Activity 没缓存旧的 Resources 实例。
容易踩的坑:以为改了 Configuration 就立刻全局生效,结果 Fragment 里 getString() 还是旧语言。
- 切语言后必须调用
recreate()(Activity)或requireActivity().recreate()(Fragment),不能只改 Context 的 Configuration - 如果用了
androidx.appcompat:appcompat1.6.1+,推荐用AppCompatDelegate.setApplicationLocales(),它会自动处理进程级 locale 设置和 Activity 重建 - 自定义
View如果缓存了context.getString()结果,切换后不会自动更新,得监听onConfigurationChanged并重设文本
最麻烦的其实是资源压缩:AGP 8.0+ 默认开启 shrinkResources true,如果某个语言的 string 只在动态代码里引用(比如通过反射或 JSON 配置加载),R8 可能把它整个删掉——这时候连 values-zh-rCN/strings.xml 文件都进不了 APK。










