Java中文文件名编译报错因javac默认用平台编码读UTF-8源文件，需加-encoding UTF-8；运行时中文路径问题源于系统与JVM编码不一致，应显式指定StandardCharsets.UTF_8并配置JVM参数或locale。
Java 编译时中文文件名报错：error: unmappable character
这是 Windows 或旧版 macOS 上最常遇到的问题——javac 默认用平台编码读取源文件，而你的 .java 文件实际是 UTF-8（比如用 VS Code、IntelliJ 新建的），结果中文字符被当乱码处理。
根本原因不是“Java 不支持中文文件名”，而是编译器没被告知该用什么编码读它。解决方式很简单：
- 强制指定输入编码：
javac -encoding UTF-8 Main.java - 如果用 IDE，别只改文件保存编码，还要检查编译器设置（如 IntelliJ 的
File Encoding→Project Encoding和Transparent native-to-ascii conversion关闭） - Gradle 用户需在
build.gradle中显式配置：compileJava.options.encoding = "UTF-8"
运行时读取中文路径的资源文件失败：FileNotFoundException 或乱码
哪怕编译过了，Class.getResource() 或 Files.readAllLines() 读含中文的路径仍可能出错——尤其在 Windows CMD 下启动 Java 程序时，控制台默认是 GBK，但 Java 运行时默认用 UTF-8 解析命令行参数和环境路径。
关键点在于：路径本身是否被正确传递，而不是 Java 能不能处理中文。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 避免直接拼接路径字符串：
"./数据/配置.txt"在某些 Shell 下会因编码不一致变成"./数据/é…" - 优先用
Paths.get()+ClassLoader.getResource()获取 classpath 内资源，它绕过系统路径编码问题 - 若必须读外部中文路径，启动 JVM 时加参数：
java -Dfile.encoding=UTF-8 MyApp（注意：这影响所有字符串操作，慎用于依赖平台编码的老代码）
Linux/macOS 下看似正常，但部署到 Docker 或 CI 就崩了
Linux 发行版大多默认 UTF-8，所以本地跑得通；但 Alpine 镜像默认没有完整 locale，CentOS 7 的 glibc locale 数据缺失，CI 环境（如 GitHub Actions 的 ubuntu-latest）也可能未预设中文 locale —— 导致 new File("测试.txt").exists() 返回 false，尽管文件明明存在。
这不是 Java 的锅，是底层 C 库对路径字节序列的解释逻辑不同。
- Docker 中补全 locale：
RUN apk add --no-cache icu-data-full && export LANG=en_US.UTF-8
（Alpine）或localedef -i zh_CN -f UTF-8 zh_CN.UTF-8
（CentOS/Debian） - CI 脚本里显式设置：
export LANG=C.UTF-8（比zh_CN.UTF-8兼容性更好） - 永远别假设
System.getProperty("file.encoding")是可靠的——它可能为空、为ANSI_X3.4-1968（即 US-ASCII），应主动用StandardCharsets.UTF_8显式指定
IDEA/Eclipse 里能跑，命令行 java -jar 就乱码
IDE 自动帮你加了 -Dfile.encoding=UTF-8，但你打包的 MANIFEST.MF 里没写，或者用 java -jar app.jar 启动时没带参数，JVM 就回落到系统默认编码。
最稳妥的做法不是靠启动参数，而是把编码选择权收回到代码里：
- 读文件不用
Files.readAllLines(path)，改用：Files.readAllLines(path, StandardCharsets.UTF_8)
- 写文件同理：
Files.write(path, lines, StandardCharsets.UTF_8) - 涉及
InputStreamReader/OutputStreamWriter，必须传入StandardCharsets.UTF_8，不要依赖无参构造函数
跨系统部署时，连“默认编码”这种概念都不可信。真正可控的，只有你显式写出的 StandardCharsets.UTF_8 和 -encoding UTF-8。
