出海第一天就翻车,鸿蒙多语言适配的坑
德语界面挤爆了按钮
应用出海第一版,德语界面一打开,按钮里的文字溢出了边框,日期显示成英语格式,弹窗里的引导语还是中文硬编码。翻译质量没问题,问题是工程没给多语言留余地。国际化不是"加个翻译文件",是一整套工程约束。这篇把第一版翻车的地方逐个复盘。

▲ 示意图 · 多语言适配
字符串必须全部资源化
第一原则:界面上任何一个字都不允许写死在代码里。所有文案进 string.json,按语言建限定目录:base 兜底、zh_CN、en_US、de_DE 各一份。
// resources/base/element/string.json
{ "string": [{ "name": "delete_confirm", "value": "确认删除这条记录?" }] }
// resources/de_DE/element/string.json
{ "string": [{ "name": "delete_confirm", "value": "Diesen Eintrag löschen?" }] }
组件里统一用 $r('app.string.delete_confirm') 引用。坑在于存量代码:我们的应用里散落着两百多处中文字面量,用静态扫描工具全量捞出来逐个处理,花了一天。这件事越晚做越贵,出海决策确定的当天就应该禁止新增字面量。
排版长度要预留
德语单词长、俄语更长,同一条文案翻译后可能比中文长出三到五成。按钮固定宽度、标签栏文字不换行、标题单行省略——这些在中文里合理的写法,德语下全部露馅。适配手段:控件尺寸给弹性空间(用百分比和 constraintSize 而不是固定宽高);长文案允许换行;关键按钮预留三成以上的宽度余量。自测方法也简单:切到德语或用伪本地化(把所有字符重复一遍拉长)过一遍界面,溢出的一眼可见。
日期数字别自己拼
'2026-11-19' 自己拼接日期,在英语用户那里就是异类。格式化交给系统。
import { i18n } from '@kit.LocalizationKit';
const locale = i18n.System.getSystemLocale(); // 如 de-DE
const fmt = new Intl.DateTimeFormat(locale, { dateStyle: 'medium' });
fmt.format(new Date()); // 德语用户看到 19.11.2026
数字、货币同理,用 Intl.NumberFormat,小数分隔符、千位符、货币符号全部按区域正确输出。订单金额自己拼一个 ¥ 前缀,出海立刻变 bug。
还有几处隐形的地雷
文案里用变量拼接的整句要改用占位符模板,"恭喜{0}获得{1}" 由翻译提供整句,程序只填词——不同语言的语序完全不同,程序拼接出来的句子在别的语言里语序错乱。图标和图片里嵌的文字(比如"免费"角标)要么切图按语言出两套,要么改成代码绘制。还有时钟:十二小时制和二十四小时制是用户偏好,别写死。最后,切换语言后的测试要覆盖完整业务流,尤其是订单确认这类组合文案,拼接错误的句子往往藏在那里。
写在最后
多语言适配的清单归拢起来:字符串全部资源化、限定目录按语言维护;排版按"翻译后长三成"预留弹性;日期数字货币交给 Intl 格式化;整句用占位符模板不做程序拼接;切换语言逐页自测。这套东西没有技术难度,全是纪律,但它决定了应用在另一个语言的用户眼里是"专业"还是"二手货"。出海的第一课不是翻译,是工程结构给变化留出位置。
更多推荐




所有评论(0)