Java ResourceBundle国际化需严格命名（如messages_zh_CN.properties）、显式传入Locale、用native2ascii处理中文乱码，且缓存全局不可热更新。
Java 的 Locale 与 ResourceBundle 能实现基础国际化，但默认机制容易踩坑——比如资源文件未加载、fallback 逻辑不符合预期、或乱码导致键值全为空字符串。
如何正确命名和放置 ResourceBundle 文件
文件名必须严格匹配 basename_language_country_variant 格式，且全部小写；ResourceBundle.getBundle() 不会自动识别大写或中划线分隔的目录结构。
- 正确示例：
messages_zh_CN.properties、messages_en_US.properties，放在类路径根目录或与调用类同包下 - 错误写法：
Messages_zh-CN.properties（含大写、中划线）、messages_zh_CN.txt（非 .properties 后缀） - 若使用模块系统（Java 9+），需在
module-info.java中显式opens包给java.base
为什么 ResourceBundle.getBundle() 总是返回默认语言资源
根本原因常是 Locale 实例未被正确传递，或 JVM 默认 Locale 覆盖了你指定的值。该方法默认启用“父类链回退”（parent chain fallback），但只按 zh_CN → zh → default 逐级查找，不会跨语种跳转（如 zh_CN → en_US）。
- 显式传入
Locale：用ResourceBundle.getBundle("messages", new Locale("zh", "CN"))，而非依赖Locale.getDefault() - 禁用自动 fallback：传入
ResourceBundle.Control.getNoFallbackControl(ResourceBundle.Control.FORMAT_PROPERTIES) - 验证当前 JVM 区域设置：
System.out.println(Locale.getDefault())，避免 IDE 或启动脚本覆盖（如-Duser.language=ja）
Properties 文件中文乱码怎么解决
ResourceBundle 加载 .properties 时**强制使用 ISO-8859-1 编码**，直接写中文会导致乱码或读成空字符串。不能靠 IDE 文件编码设置绕过。
立即学习“Java免费学习笔记（深入）”；
- 方案一（推荐）：用
native2ascii工具转义——native2ascii -encoding UTF-8 messages_zh_CN.properties messages_zh_CN_ja.properties - 方案二：改用
PropertyResourceBundle+InputStreamReader手动加载 UTF-8 文件（需自定义ResourceBundle.Control） - 方案三：跳过
.properties，改用 JSON/YAML + 自定义ResourceBundle子类（适合新项目）
public class UTF8PropertyResourceBundle extends ResourceBundle {
private final Properties props;
public UTF8PropertyResourceBundle(String filename) throws IOException {
this.props = new Properties();
try (InputStream is = getClass().getClassLoader().getResourceAsStream(filename);
Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
props.load(reader);
}
}
@Override
protected Object handleGetObject(String key) { return props.get(key); }
@Override
public Enumeration<String> getKeys() { return props.propertyNames(); }
}
Locale 构造时 country 和 variant 的实际影响
country 决定区域格式（如日期、数字分隔符），variant 用于更细粒度区分（如字体、方言），但 ResourceBundle 查找时仅将 variant 作为文件名一部分，不参与任何逻辑判断。
- 常见误用：
new Locale("en", "US", "POSIX")试图启用 POSIX 格式，但ResourceBundle只查找messages_en_US_POSIX.properties，不存在就直接 fallback 到en_US - 真正影响格式化的是
DateFormat、NumberFormat等类，与ResourceBundle无关 - Android 开发者注意：Android 的
Resources.getIdentifier()机制与 Java SE 完全不同，不要套用这套逻辑
最易被忽略的一点：ResourceBundle 缓存是全局静态的，一旦加载成功就会缓存整个链路（包括 fallback 结果）。修改 properties 文件后必须重启 JVM，热更新需自行实现缓存清除或换用非标准加载器。
