JavaFX属性文件加载异常：中文区域下界面显示错乱排查

问题根源 #

这不是JavaFX的问题，问题出在属性文件本身或加载逻辑上，结合你描述的“部分字符串正常、仅中文区域电脑出现错乱”的现象，最可能的原因是：

• UTF-8 BOM字节顺序标记干扰：如果属性文件是在Windows系统下用记事本等工具保存为UTF-8编码，文件开头会自动添加一个不可见的UTF-8 BOM（\uFEFF）。Java的InputStreamReader不会自动跳过这个标记，导致读取的第一个属性的键或值前缀包含该字符，显示到JavaFX界面时就会出现错乱；而后续的属性不受影响，因此出现“部分正常、部分错乱”的情况。

其他低概率原因：

• 资源文件路径在中文Locale环境下的类加载器解析异常（但你用类名拼接路径，类名是ASCII的话基本不会出现）；
• 中文系统默认字体对特定ASCII字符的渲染问题（但通常会影响同类型所有字符，而非部分）。

解决方案 #

1. 移除UTF-8 BOM：用Notepad++、VS Code等工具打开属性文件，选择“UTF-8无BOM”编码重新保存，彻底消除BOM的影响。

2. 手动跳过BOM（代码层面兼容）：如果无法修改文件编码，可在读取时手动检测并跳过BOM：

   InputStream in = cls.getResourceAsStream("resources/" + cls.getSimpleName() + ".properties");
   PushbackInputStream pbIn = new PushbackInputStream(in, 3);
   byte[] bomBuffer = new byte[3];
   int readBytes = pbIn.read(bomBuffer);
   // 判断是否为UTF-8 BOM，不是的话将字节推回流中
   if (!(readBytes == 3 && bomBuffer[0] == (byte) 0xEF && bomBuffer[1] == (byte) 0xBB && bomBuffer[2] == (byte) 0xBF)) {
       pbIn.unread(bomBuffer, 0, readBytes);
   }
   properties.load(new InputStreamReader(pbIn, StandardCharsets.UTF_8));
   

3. 改用ResourceBundle管理资源（推荐）：Java的ResourceBundle是专门用于本地化资源管理的工具，能自动处理Locale适配，且可通过自定义Control支持UTF-8编码，避免手动加载的潜在问题：

   // 自定义Control支持UTF-8属性文件
   ResourceBundle.Control utf8Control = new ResourceBundle.Control() {
       @Override
       public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload) throws IllegalAccessException, InstantiationException, IOException {
           String bundleName = toBundleName(baseName, locale);
           String resourceName = toResourceName(bundleName, "properties");
           try (InputStream stream = loader.getResourceAsStream(resourceName)) {
               if (stream != null) {
                   try (InputStreamReader reader = new InputStreamReader(stream, StandardCharsets.UTF_8)) {
                       return new PropertyResourceBundle(reader);
                   }
               }
           }
           return super.newBundle(baseName, locale, format, loader, reload);
       }
   };
   // 根据当前Locale加载资源
   ResourceBundle bundle = ResourceBundle.getBundle("resources." + cls.getSimpleName(), Locale.getDefault(), utf8Control);
   

内容的提问来源于stack exchange，提问作者DbSchema