为何Path.toString()在Linux下无法显示全部字符，Windows下却正常？

这种特殊字符显示为黑菱形问号的问题，本质是字符编码不匹配导致的——Linux和Windows对文件系统文件名的编码处理逻辑差异，加上JVM默认编码的影响，才出现了跨系统的不一致。

为什么Windows正常，Linux出问题？ #

• Windows的NTFS文件系统用UTF-16存储文件名，Java在Windows环境下会自动将UTF-16转换为JVM默认编码（通常是GBK或UTF-8，取决于系统区域设置），只要你的特殊字符在目标编码中有映射，就能正常显示。
• Linux的文件系统（比如ext4）默认用UTF-8存储文件名，但如果你的Java程序在Linux上的JVM默认编码不是UTF-8（比如ISO-8859-1），当调用Path.toString()时，Java会用错误的编码解析文件名，导致无法识别的字符被替换为�（黑菱形问号）。

分步解决方案 #

1. 强制JVM使用UTF-8编码启动 #

这是最直接的修复方式，确保JVM用UTF-8解析文件名。在启动Java程序时添加如下参数：

java -Dfile.encoding=UTF-8 -jar your-app.jar

如果是IDE运行（比如IntelliJ），可以在Run Configuration的VM Options里添加-Dfile.encoding=UTF-8。

2. 代码层面避免直接用Path.toString() #

如果无法修改JVM启动参数，可以在代码里手动处理编码，优先通过URI来获取正确的UTF-8路径：

import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;
import java.nio.file.Path;

// 替换原来的path.toString()
public String getEncodedPath(Path path) {
    // 将Path转为URI（URI默认用UTF-8编码路径）
    String uriPath = path.toUri().getPath();
    // 解码URI的编码，得到原始UTF-8字符串
    return URLDecoder.decode(uriPath, StandardCharsets.UTF_8.name());
}

这样无论JVM默认编码是什么，都能正确解析带特殊字符的文件名。

3. 确保JSON生成时用UTF-8编码 #

在将路径结构转为JSON时，要保证JSON输出是UTF-8编码，避免特殊字符被转义或乱码。以常用的Jackson库为例：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.core.JsonGenerator;
import java.nio.charset.StandardCharsets;
import java.util.Map;

public String pathStructureToJson(Map<String, Object> pathTree) throws Exception {
    ObjectMapper mapper = new ObjectMapper();
    // 关闭非ASCII字符转义，保留原始特殊字符
    mapper.configure(JsonGenerator.Feature.ESCAPE_NON_ASCII, false);
    // 直接生成UTF-8字节数组再转字符串
    byte[] jsonBytes = mapper.writeValueAsBytes(pathTree);
    return new String(jsonBytes, StandardCharsets.UTF_8);
}

4. HTML页面确保UTF-8渲染 #

最后，在HTML页面中明确指定编码，让浏览器正确解析JSON中的特殊字符：

<head>
    <meta charset="UTF-8">
    <!-- 其他头部内容 -->
</head>

验证方案 #

修改后，你可以在Linux上打印处理后的路径字符串，或者查看HTML页面的渲染效果——特殊字符应该和Windows上显示一致了。

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