用途:在 UI 文案需要支持多语言时使用,重点处理翻译后出现的布局、语法与格式化问题,而非单纯缺翻译。核心原则是把文案视为变长、变序、变形的数据,不要按英文长度一次性测量固定文本。
主要能力:分为文案与布局两部分。布局方面,避免单行定宽容器,翻译后文本长度常为英文的约130%至300%,最短字符串膨胀最明显;德语、芬兰语、荷兰语复合词会形成长不可断词;泰语、阿拉伯语、天城文、CJK 字形更高,需留额外行高;在 html 上设置 lang 与 dir,二者机制不同,方向不能由语言推导;用 CSS 逻辑属性(如 margin-inline-start、inset-inline)布局以便 RTL 自动镜像,注意 dir="ltr" 孤岛(邮箱、URL、代码);用真实译文或伪本地化验证,不要用英文或 Lorem。
文案方面:不要用 count === 1 判断单复数,应通过 Intl.PluralRules / ICU plural 选择,CLDR 有六类(阿拉伯语全用,CJK 仅 other);不要拼接句子片段,使用完整句模板加具名占位符;插值无法解决性别/冠词一致,需用 ICU select;数字、日期、货币用 Intl 格式化,不要硬编码 $、MM/DD/YYYY 或标点。Intl 只负责格式化,不负责解析或存储。
适用场景与限制:适合代码审查中按文案、语法、布局、格式化四类契约提出可评审的迁移建议。仅当影响用户界面且迁移路径小可评审时才计为问题;开发者日志、测试夹具、产品名、协议字面量、品牌英文文案、已接入翻译但缺某语言文件、CJK 断行与 IME 行为等应排除。若问题是渲染 UI 与设计稿不一致而非翻译,应转其他技能。
输出形态:报告语言与用户界面、所属契约、具体证据、最小 i18n 系统改动,以及非英语、复数、RTL 或伪本地化回归验证。