> 本文整理自平台文档 docs/wujies/5.x/ruoyi-vue-plus/framework/extend/translation.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-ed25507ffa99-cover.svg)
- - -
版本
- >= 4.6.0
注解说明
@Translation:标注在实体字段上,用于声明需要翻译的字段。 @TranslationType:标注在实现类上,与 @Translation 的 type 一致,用于实现翻译逻辑。

补充说明:
- 这套能力适合把“数据库里存的 ID / code”在返回前自动翻译成可展示字段。
- 常见场景包括用户名称、部门名称、字典标签、OSS 地址等。
使用说明
注意:翻译功能基于序列化实现,仅适合小数据量场景,不适用于 Excel 等大数据量导出。 建议缓存翻译结果,减少重复查询。
内置翻译类型:
- 用户 ID -> 账号/用户名
- 部门 ID -> 部门名称
- 字典 type -> label
- OSS ID -> URL
示例说明:
- 映射翻译:根据另一个字段映射到当前字段
- 直接翻译:根据当前字段直接替换
- 其他条件翻译:基于
other自定义条件
   
补充说明:
- 由于翻译发生在序列化阶段,所以返回列表越大,翻译开销越明显。
- 如果是导出、批量同步、离线任务等大数据量场景,建议提前查询并手动组装,不要完全依赖序列化翻译。
自定义扩展
实现 TranslationInterface 并标注 @TranslationType,可参考框架默认实现。

补充说明:
- 自定义翻译器时,建议优先考虑加缓存,避免每次序列化都重复查库或远程调用。
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-ed25507ffa99-guide.svg)


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