使用Files.walk()递归读取目录时西里尔字符显示乱码求助

问题现象 #

• 使用Files.walk()递归读取目录时，含西里尔字符的文件名在IntelliJ控制台显示为????，ListView中显示为�����
• 自定义listFileTree()方法直接忽略带西里尔字符的文件
• 已配置IntelliJ编码、控制台编码为UTF-8，添加VM参数-Dconsole.encoding=UTF-8和-Dfile.encoding=UTF-8，编码转换操作无效
• 但通过FileChooser选择文件、硬编码西里尔字符到ListView时，显示均正常

核心原因 #

问题出在文件路径的字符串编码处理错误：Files.walk()返回的Path对象本身已正确存储文件名的Unicode信息，但如果遍历过程中错误地将Path转为字符串时依赖了系统默认编码（而非UTF-8），或使用了依赖系统编码的老旧文件API（如File.list()），就会导致乱码或文件被忽略。

解决方案 #

1. 始终使用Path对象处理文件路径 #

遍历过程中直接操作Path对象，获取文件名时调用path.getFileName().toString()，避免先将整个路径转为字符串再处理：

import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.util.stream.Stream;
import javafx.application.Platform;
import javafx.scene.control.ListView;

// 在JavaFX应用中调用
try (Stream<Path> paths = Files.walk(Paths.get("你的目标目录路径"))) {
    paths.filter(Files::isRegularFile)
         .forEach(path -> {
             // 直接从Path获取Unicode文件名
             String fileName = path.getFileName().toString();
             // 切换到JavaFX主线程更新ListView
             Platform.runLater(() -> yourListView.getItems().add(fileName));
         });
} catch (Exception e) {
    e.printStackTrace();
}

2. 修复自定义listFileTree()方法 #

如果你的自定义遍历方法使用了File类的老旧API，替换为Files和Path的组合：

• 错误实现（会忽略非ASCII文件名）：

  // 不推荐：依赖系统默认编码，导致西里尔字符文件丢失
  public void listFileTree(File dir, ListView<String> listView) {
      File[] files = dir.listFiles();
      if (files == null) return;
      for (File file : files) {
          if (file.isDirectory()) listFileTree(file, listView);
          else listView.getItems().add(file.getName());
      }
  }
  

• 正确替换：

  public void listFileTree(Path dir, ListView<String> listView) {
      try (Stream<Path> paths = Files.list(dir)) {
          paths.forEach(path -> {
              if (Files.isDirectory(path)) {
                  listFileTree(path, listView);
              } else {
                  String fileName = path.getFileName().toString();
                  Platform.runLater(() -> listView.getItems().add(fileName));
              }
          });
      } catch (Exception e) {
          e.printStackTrace();
      }
  }
  // 调用时传入Path对象
  listFileTree(Paths.get("你的目标目录路径"), yourListView);
  

3. 确保编码设置完全生效 #

• 检查IntelliJ设置：
  • 进入File > Settings > Editor > File Encodings，将IDE Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8
  • 在Run/Debug Configurations的VM参数中，确认添加了-Dconsole.encoding=UTF-8 -Dfile.encoding=UTF-8，且无重复或冲突参数
• 重启IntelliJ，确保设置生效

4. 验证系统文件编码支持 #

• Windows系统：开启UTF-8全局支持——进入「设置>时间和语言>语言>管理语言设置>更改系统区域设置」，勾选「Beta版：使用Unicode UTF-8提供全球语言支持」，重启系统
• Linux/macOS：默认已支持UTF-8文件名，无需额外配置

验证步骤 #

1. 创建含西里尔字符的测试文件（如тест-документ.txt）
2. 使用修改后的递归代码读取目录
3. 检查ListView和控制台是否正确显示文件名

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