> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/association/i18n.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-4c4255c5973e-cover.svg)
- - -
前端国际化
参考 RuoYi 前端国际化文档:
- http://doc.ruoyi.vip/ruoyi-vue/document/htsc.html#前端国际化流程
补充说明:
- 当前前端项目已经内置
zh_CN、en_US两套语言资源,目录位于plus-ui/src/lang。 - 请求发送时会自动把当前语言写入请求头
Content-Language,后端无需前端每个接口手动重复传参。
后端国际化
- 2.7.0 以上支持后端国际化
- 3.4.0 以上支持
Validator校验国际化
参考 demo 模块 TestI18nController。
请求头中增加 content-language,值需与国际化资源文件后缀一致,例如 zh_CN、en_US。

补充说明:
- 当前项目通过
I18nLocaleResolver从请求头content-language解析语言环境。 - 如果请求头未传该值,则回退到服务端默认语言环境。
- 业务代码中可以直接使用
MessageUtils.message("code")获取国际化文案。
获取 code 对应国际化内容
<br /> <br /> 
Validator 校验国际化(Controller)
Controller 参数校验需在类上增加 @Validated。
<br />
校验注解使用 {code} 形式绑定国际化:
<br /> <br /> 
Validator 校验国际化(Bean)
Bean 校验需在方法参数上使用 @Validated。
<br />
Bean 内字段校验注解使用 {code} 绑定国际化:
<br /> 
补充说明:
- 校验消息使用
{code}时,本质上还是走 SpringMessageSource,所以对应的资源文件里必须存在该 key。 - 自定义异常、业务提示、限流/幂等等公共组件的提示语,同样可以统一接入国际化资源,保持前后端文案一致。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-4c4255c5973e-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。