Java Swing程序无法正常显示德语变音符号(ä、ö等)的原因是什么？

问题原因 #

该问题核心是Windows环境下的编码不匹配导致：Linux默认系统编码为UTF-8，和你的源码编码一致，所以编译运行都正常；Windows默认编码为GBK，无额外配置的情况下javac编译器会用系统默认编码读取UTF-8格式的源码，导致字符串常量中的特殊字符在编译阶段就已经被转成乱码，后续不管用什么字体都无法正常显示。

解决方案 #

1. 配置Gradle强制使用UTF-8编译 #

在项目根目录的build.gradle文件中添加以下配置：

// 编译Java源码时指定编码
tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}
// 处理资源文件时指定编码
tasks.withType(ProcessResources) {
    encoding = "UTF-8"
}
// 如果用gradle run命令启动程序，添加运行时编码参数
tasks.withType(JavaExec) {
    jvmArgs '-Dfile.encoding=UTF-8'
}

修改配置后执行clean build重新构建项目再运行即可。

2. 手动指定JVM启动参数 #

如果是打包后独立运行jar包，启动时添加编码参数：
java -Dfile.encoding=UTF-8 -jar 你的包名.jar

3. 兜底方案：使用Unicode转义字符 #

如果以上配置都无效，可以直接把源码中的特殊字符替换为Unicode转义写法，完全规避编码问题：

• Ü 替换为 \u00dc
• ß 替换为 \u00df
• ä 替换为 \u00e4
• ö 替换为 \u00f6
  示例：

about.setToolTipText("\u00dcber das Programm");
test.setText("<html>Something with \u00df</html>");

验证方法 #

可以在代码中加一行日志输出包含变音符号的字符串，查看控制台输出：
System.out.println("Über ß");
如果输出本身就是乱码，说明问题出在编译/运行编码配置环节，如果输出正常才需要进一步排查字体渲染问题。

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