结论先行:前端国际化(i18n)的工程量不在翻译,而在四件基础设施——文案的 key 化管理与提取流程、时区与货币的正确格式化、RTL 布局的镜像能力、以及语言包的构建与发布策略。原则是「代码里零硬编码文案、存储一律 UTC、金额一律最小单位整数、布局用逻辑属性」。这四条在立项时定下来,后面加一门语言只是翻译成本;立项时没定,后面每加一门语言都是一次小型重构。国际化不是把中文换成英文,而是让产品具备「随时长出任何语言」的能力。
一、文案管理:key 规范与提取流程
第一原则:代码中不允许出现面向用户的硬编码文案,全部走 i18n 函数。key 的命名推荐「模块.页面.语义」三段式,例如 cart.checkout.submit,禁止用中文原文当 key(改文案就断链),也禁止用无意义的编号。带变量的文案用插值而不是字符串拼接:「共 {count} 件商品」在不同语言里语序不同,拼接必然出错。
复数是中文开发者最容易漏的点:英文有 one/other,俄语阿拉伯语有更复杂的复数规则。用 ICU MessageFormat 语法声明复数,交给 vue-i18n 或 FormatJS 这类成熟库处理,不要自己写 if 判断。流程上建立「提取—翻译—回填」闭环:开发只写源语言文案,脚本定期提取成语言包,翻译平台或译者补齐其他语言,CI 校验缺失 key 并告警。语言包是代码资产,进版本库、走评审,而不是散落在共享表格里。
二、时区:存储 UTC,展示本地
规则只有一条:后端存储与接口传输一律 UTC(ISO 8601 字符串或时间戳),前端在展示层转成用户时区。用原生 Intl.DateTimeFormat 即可完成格式化,不需要为每个语言手写日期模板。
const fmt = new Intl.DateTimeFormat('zh-CN', {
dateStyle: 'medium',
timeStyle: 'short',
timeZone: 'Asia/Shanghai',
})
fmt.format(new Date(order.createdAt))三个高频坑:把「用户选择的时区」与「浏览器时区」混为一谈,跨国业务要允许用户显式指定;跨天边界计算(如「今日订单」)必须在目标时区下算,不能拿本地零点直接比;夏令时地区不要用固定偏移量加减,交给 Intl 与 IANA 时区名处理。倒计时与相对时间(「三分钟前」)用 Intl.RelativeTimeFormat,同样避免手写。
三、货币:最小单位整数加 Intl 格式化
金额在系统内部用最小单位的整数(分)存储与计算,彻底避开浮点误差;展示时用 Intl.NumberFormat 的 currency 风格输出,符号位置、千分位、小数位数全部由 locale 决定。日元没有小数位、部分中东货币小数位是三位,手写 toFixed(2) 在这些市场直接出错。
const price = new Intl.NumberFormat('ja-JP', {
style: 'currency',
currency: 'JPY',
}).format(1980)还要区分「展示货币」与「结算货币」:用户可以用本地货币浏览价格,但下单结算必须锁定一种货币并记录汇率快照,否则对账会出灾难。折扣计算先算后格式化,永远不要对格式化后的字符串做运算。
四、RTL:逻辑属性一次到位
阿拉伯语、希伯来语是从右向左书写,镜像的不只是文字方向,还有整个布局。现代 CSS 的答案是逻辑属性:margin-inline-start 替代 margin-left,padding-inline-end 替代 padding-right,text-align: start 替代 left,inset-inline-start 替代 left 定位。html 上设置 dir='rtl' 后,这些属性自动镜像,一套样式服务两个方向。
需要手动处理的少数派:方向性图标(返回箭头、播放键)要镜像,用 transform: scaleX(-1) 或准备两套资源;数字与电话号码在 RTL 语境下仍从左到右,用 unicode-bidi 隔离;阴影与渐变里的物理方向要检查。Flex 与 Grid 天然跟随方向,是 RTL 友好的布局方式,浮动布局则是重灾区,能换就换。
五、内容型数据的国际化:别都塞进语言包
界面文案进语言包,但商品描述、文章内容、Banner 标题这类运营数据不该进——它们由运营人员随时编辑,走代码发布流程太重。正确做法是后端按语言维度存储内容,接口按当前 locale 返回对应版本。
以 api工厂为例,它的 CMS 文章与 Banner 能力(接口文档见 https://www.it120.cc/sdk/index.html )可以承担这类结构化内容管理:运营在现成管理后台维护多语言内容,前端通过开放接口按语言拉取,界面文案与运营内容各走各的通道。商城类项目还可以参考其开源前端与真实案例( https://www.it120.cc/cases.html ),观察商品数据与界面文案分离的组织方式。这样翻译界面不需要动内容,更新内容也不需要发版,两条流水线互不阻塞。
六、构建、发布与质量保障
语言包按 locale 拆分并懒加载,首屏只加载当前语言,切换语言时动态拉取,避免把几十种语言全打进主包。语言包文件带内容哈希走 CDN 长缓存,更新即失效。SEO 层面为每种语言提供独立 URL 与 hreflang 标注,别指望前端切换语言能被搜索引擎收录。
质量保障三件事:CI 校验各语言 key 完整性与插值变量一致性;用伪本地化(把文案替换成带重音符号的加长版本)提前暴露截断与硬编码;每个目标市场至少一次真机走查,重点看日期、货币、RTL 与字体回退。字体也要按语言配置回退链,阿拉伯语与泰文的默认字体渲染差异很大,不指定就会出豆腐块或错位。
文章标签
相关产品
api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。