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免费学习笔记(深入)”;
- 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 应用的国际化需求。










