Java多语言国际化封装核心是文案与语言逻辑分离，通过统一key查ResourceBundle或MessageSource动态加载；封装工具类提供get(key,args)方法自动处理Locale、占位符填充及兜底；错误文案用枚举管理，含code、i18nKey和默认文案，并集成Spring MessageSource实现自动回退与全局异常翻译。

Java 封装多语言国际化文案处理，关键是把“文案内容”和“语言逻辑”彻底分开，让业务代码只关心“要说什么”，不关心“用哪种语言说”。核心不是硬编码字符串，而是用统一的键（key）去查资源，再由 ResourceBundle 或 Spring 的 MessageSource 动态加载对应语言的值。

封装资源加载与解析逻辑

避免在每个类里重复写 ResourceBundle.getBundle(...) 和 MessageFormat.format(...)。推荐封装一个工具类或服务，集中管理：

• 指定统一的 basename（如 i18n.messages），确保所有资源文件按 messages_zh_CN.properties、messages_en_US.properties 命名并放在 classpath 正确路径下
• 提供静态方法 get(String key, Object... args)，内部自动获取当前 Locale（可从 ThreadLocal、LocaleContextHolder 或请求上下文提取）
• 调用 MessageFormat.format(bundle.getString(key), args) 完成占位符填充，不拼接字符串
• 兜底处理：key 不存在时返回 key 本身或默认英文文案，避免抛 MissingResourceException

用枚举统一管理错误文案键

对异常提示、校验失败等固定语义场景，用枚举封装比散落的字符串 key 更安全、更易维护：

sc-java-to-ts-interface

将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。

下载

• 每个枚举项包含唯一 code（如 USER_LOGIN_FAILED）、i18nKey（如 "error.login.failed"）和英文默认文案
• 枚举中实现 getMessage(Locale locale) 方法，优先查 ResourceBundle，失败则返回默认文案
• 自定义异常（如 BusinessException）构造时传入该枚举，重写 getLocalizedMessage() 委托给枚举解析
• 这样异常对象本身无语言绑定，同一实例在不同 Locale 下调用 getMessage() 可返回不同语言文本

结合 Spring 的 MessageSource 简化集成

Spring Boot 项目优先使用 ResourceBundleMessageSource 或 ReloadableResourceBundleMessageSource（支持热更新）：

立即学习“Java免费学习笔记（深入）”；

• 配置 spring.messages.basename=i18n/messages，自动匹配 classpath 下的 i18n/messages_*.properties
• 在 @ControllerAdvice 全局异常处理器中注入 MessageSource，捕获自定义异常后调用 messageSource.getMessage(code, args, locale)
• 响应前端时直接返回已翻译的友好提示；原始异常堆栈仅记日志，不暴露
• 支持完整回退链：zh_CN → zh → 默认 messages.properties，无需手动判断 Locale 层级

注意资源文件命名与路径规范

ResourceBundle 对文件名和位置极其敏感，封装再好也绕不开基础规则：

• 默认资源必须是 messages.properties（不能叫 messages_en.properties），否则 fallback 失效
• 中文简体严格用 messages_zh_CN.properties；zh_CH 或 zh 不一定被识别，取决于 JVM Locale 构造方式
• 文件必须放在 classpath 根路径或与 basename 路径一致的位置；例如 basename 是 i18n/messages，则文件需在 src/main/resources/i18n/messages_zh_CN.properties
• Maven/Gradle 构建时确认 .properties 已复制到 target/classes，否则运行时报 MissingResourceException