多语言
界面和后端提示支持简体中文(默认)和英文,顶栏和登录页右上角切换。卖家面对的是多国平台,界面语言与平台站点无关:订单、商品等来自平台的数据按原文显示。
前端(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 会运行这两个检查,提交前请在本地先跑一遍。