Skip to content

多语言 ​

界面和后端提示支持简体中文(默认)和英文,顶栏和登录页右上角切换。卖家面对的是多国平台,界面语言与平台站点无关:订单、商品等来自平台的数据按原文显示。

前端(vue-i18n) ​

  • 语言包按模块拆分:src/locales/<语言>/<模块>.js,键为 <模块>.<页面>.<文字>,两种语言的键必须一致。电商的语言包较多:ecom.js、ecomOrder.js、ecomReport.js、ecomPublish.js、ecomAds.js、ecomCs.js、ecomFba.js、ecomOwh.js、ecomOper.js、ecomDev.js、ecomProfit.js、ecomDemo.js 等。
  • 模板中用 $t('…'),<script setup> 中用 useI18n().t,普通 js 模块用 import { t } from '@/locales'。插值写 {name};@ | $ { } 要写成 {'@'}。整句带参数翻译,不要拼接中英文片段。
  • 菜单按 ID 翻译(locales/en-US/menu.js),字典按类型和值翻译(locales/en-US/dict.js);新增菜单、字典时补英文。
  • 状态 / 类型比较用 @/constants/enums 中的常量(如 record.localStatus === EcomLocalStatus.PENDING)。该文件由 npm run gen:enums 从后端与文件同名的 Java 枚举生成,不要手工修改;后端新增或修改枚举后重新生成。业务字典的值不在其中。
  • 检查:npm run i18n:check——两种语言的键是否一致、代码中使用的键是否存在、代码中是否残留中文(注释除外,有意保留的写 i18n-ignore),以及枚举常量是否与后端一致。

后端(Spring MessageSource) ​

  • 消息在各模块的 src/main/resources/i18n/<模块>.properties(中文)和 <模块>_en.properties(英文),键为 <模块>.<分类>.<名称>:error 业务异常、valid 校验、text 返回前端的文字、label 名称、enum 枚举名称。参数按 MessageFormat 写作 {0},单引号写成两个。
  • 语言由 Accept-Language 决定,定时任务、异步线程中为中文。
  • 业务异常 new BizException("ecom.error.listingSkuExists", sku);校验注解 message = "{ecom.valid.xxx}";其他文字 Messages.get("ecom.text.xxx")。
  • 连接器的授权字段名称、能力说明、回调说明都是消息键(ecom.label.cred.<平台>.*、ecom.text.connector.*)。
  • 存入数据库的内容(站内消息、操作日志、单据摘要、自动生成的数据、演示数据)保留中文,或用 Messages.get(Messages.DEFAULT_LOCALE, 键)。
  • 检查:python3 scripts/check_i18n.py——资源包中英文键与占位符一致、英文中没有中文、单引号转义、代码中使用的键存在、Java 代码中没有残留中文。

CI 会运行这两个检查,提交前请在本地先跑一遍。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com