ResourceBundle 是 Java 标准国际化机制，按 Locale 加载键值对资源，依赖 basename 规范命名（如 messages_zh_CN.properties）、classpath 存放、getBundle() 加载、getString() 取值，支持回退机制与自定义 Control 热更新。
ResourceBundle 是 Java 提供的标准国际化（i18n）机制，用于根据当前 Locale 加载对应语言的文本资源，核心是“按需加载、自动匹配、类型安全（相对）”。它不负责翻译，只负责组织和读取已有的多语言键值对。
资源文件命名与存放位置要规范
ResourceBundle 通过基名（basename）查找资源，实际加载时会按 basename + "_" + language + "_" + country（如 messages_zh_CN.properties）或 basename + "_" + language（如 messages_en.properties）的规则匹配文件。默认使用 basename.properties（无下划线）作为基础资源（fallback）。
- 文件必须放在 classpath 下，通常放在
src/main/resources中 - 推荐使用
.properties格式（支持 Unicode 转义，如\u4f60\u597d），也可自定义 ResourceBundle.Control 实现加载其他格式（如 JSON、YAML） - 若找不到精确匹配的 Locale，会按顺序回退：zh_CN → zh → 默认（无后缀）
加载方式：用 ResourceBundle.getBundle() 最常用
最标准的加载方式是调用静态方法 ResourceBundle.getBundle(String basename, Locale locale)。不传 locale 时使用 Locale.getDefault()。
- basename 是类路径下的相对路径（不含扩展名），例如
"i18n.messages"对应i18n/messages_zh_CN.properties - 建议显式传入 Locale，避免依赖系统默认值导致测试/部署环境行为不一致
- ResourceBundle 缓存实例，重复调用相同 basename+locale 不会重复解析文件
获取文本：用 getString(key) 安全取值
拿到 ResourceBundle 实例后，用 getString(String key) 获取翻译文本。注意：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- key 不存在时抛出
MissingResourceException，生产环境建议包裹 try-catch 或提前校验 - 不支持嵌套占位符（如
{0}），需配合MessageFormat.format()使用，例如：
String msg = rb.getString("welcome.user");
String formatted = MessageFormat.format(msg, "张三"); - 避免在 ResourceBundle 中存复杂结构（如 HTML 片段、带样式的文本），保持纯文本职责清晰
进阶技巧：自定义 Control 实现热更新或动态加载
默认 ResourceBundle 每次加载都走 JVM 类加载器，内容不可变。如需运行时更新资源（比如管理员修改了配置），可继承 ResourceBundle.Control 并重写 newBundle() 方法，改用文件监控或数据库读取。
- 覆盖
getFormats()指定支持的格式（如只支持 PROPERTIES） - 重写
newBundle()返回自定义的 ResourceBundle 子类（如从磁盘实时读取） - 调用 getBundle 时传入该 Control 实例：
getBundle(name, locale, control)
基本上就这些。ResourceBundle 简单但容易忽略回退逻辑和异常处理，用好关键在规范命名、显式指定 Locale、配合 MessageFormat 做参数化，再辅以轻量封装（比如工具类统一加载+兜底），就能稳定支撑多数 Java 应用的国际化需求。
