ResourceBundle 适合轻量静态文案，但不支持热更新、复数/性别规则及动态语言切换；需严格按 basename_language_country_variant 命名并置于 classpath 正确路径；MissingResourceException 多因路径、Locale 不匹配或构建未包含资源文件；参数化文本须配合 MessageFormat，禁用字符串拼接；动态切换应避免默认 ResourceBundle，推荐自定义 ResourceBundleProvider 或外部配置中心方案。
Java 的 ResourceBundle 能实现基础多语言切换，但默认只支持 .properties 文件、不支持热更新、无法处理复数/性别等复杂本地化规则——它适合轻量级静态文案，不适合现代 Web 或富客户端应用。
如何正确命名和放置资源文件
文件名必须严格遵循 basename_language_country_variant 格式，且 basename 在代码中加载时不能带后缀或语言信息。JVM 按照 Locale 查找顺序匹配：先找带国家代码的（如 messages_zh_CN），再退回到语言码（messages_zh），最后 fallback 到默认（messages）。
- 默认资源文件必须命名为
messages.properties（不能是messages_en.properties），否则找不到 fallback - 中文简体必须用
messages_zh_CN.properties，写成messages_zh_CH.properties或messages_zh.properties可能不生效（取决于 JVM 实现和 Locale 构造方式） - 文件必须放在 classpath 下与包路径一致的位置；若类在
com.example.i18n包中，资源也应放在src/main/resources/com/example/i18n/目录下
为什么 ResourceBundle.getBundle() 总抛 MissingResourceException
这不是编码问题，而是类加载路径或 Locale 匹配失败的典型表现。常见原因有三个：
-
getBundle("messages")中的"messages"是相对于 classpath 根的路径，不是包名；若资源在lang/子目录下，得写getBundle("lang/messages") - 显式传入的
Locale和实际存在的文件名不匹配，例如传了new Locale("zh", "TW")，但只有messages_zh_CN.properties - Maven/Gradle 编译时未将
.properties文件复制到target/classes；检查构建输出目录是否存在对应文件，必要时在pom.xml中配置<resources></resources>显式包含
如何安全地读取带参数的国际化字符串
ResourceBundle 本身不解析占位符，需配合 MessageFormat 使用。直接拼接字符串会破坏翻译完整性，且无法支持不同语言的语序差异（比如日语主宾谓结构）。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
示例：messages_zh_CN.properties 中写 greeting=你好，{0}！今天是{1,date,short}，Java 中调用：
String pattern = bundle.getString("greeting");
String msg = MessageFormat.format(pattern, "张三", new Date());- 占位符必须用
{0}、{1}等索引，不能用{name}或$1 -
MessageFormat对单引号有特殊转义规则：两个单引号''才表示字面单引号，一个单引号会中断解析 - 避免在
getString()后做字符串拼接，例如bundle.getString("prefix") + name + bundle.getString("suffix")—— 这在阿拉伯语等从右向左语言中会彻底错乱
为什么 ResourceBundle 不该用于动态语言切换
ResourceBundle.getBundle() 返回的对象会被 ResourceBundle.Control 缓存，且默认缓存永不刷新。即使你切换了线程的 Locale，再次调用 getBundle() 仍可能返回旧实例。
- 没有内置机制监听语言变更；每次切换都得手动清空缓存（通过
ResourceBundle.clearCache()），但该方法影响全局，可能干扰其他模块 - 无法按需加载子模块资源（如仅加载“支付页”相关 key），所有 key 都随 bundle 一次性加载进内存
- 不支持 JSON/YAML 等现代格式，也无法集成 ICU MessageFormat 的复数规则（
plural={count, plural, one{# item} other{# items}}）
真正需要运行时切语言的场景，建议用 java.util.spi.ResourceBundleProvider 自定义实现，或直接迁移到 Apache Commons Text 的 StringSubstitutor + 外部配置中心方案。
