JavaFX：通过代码设置含特殊字符文本值的乱码问题

以下是几种更优的解决方案，替代Unicode转义序列：

1. 强制编译时使用UTF-8编码 #

Java编译器默认编码依赖系统环境，可能不是UTF-8，导致代码中的特殊字符编译时被错误转换。需要显式指定编码：

• Maven项目：在pom.xml中添加编码配置

  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
  </properties>
  

• Gradle项目：在build.gradle中配置编译选项

  tasks.withType(JavaCompile) {
      options.encoding = 'UTF-8'
  }
  

• 命令行编译：添加-encoding参数

  javac -encoding UTF-8 YourClass.java
  

2. 验证IDE的编码配置 #

确认IDE的全局和项目编码都设置为UTF-8，同时确保编译环节也使用UTF-8：

• 比如IntelliJ IDEA：
  1. 打开File > Settings > Editor > File Encodings，将Project Encoding和Default encoding for properties files设为UTF-8
  2. 进入Build, Execution, Deployment > Compiler > Java Compiler，在Additional command line parameters中添加-encoding UTF-8

3. 配置JVM运行时编码 #

启动应用时添加JVM参数，强制运行时使用UTF-8：

java -Dfile.encoding=UTF-8 -jar YourApp.jar

如果是IDE运行，在Run/Debug Configuration的VM options中添加该参数。

4. 从外部UTF-8资源文件加载文本 #

如果特殊字符文本较多，建议将内容存入UTF-8编码的文本文件，读取时显式指定编码：

import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Paths;

String text = Files.readString(Paths.get("resources/special-chars.txt"), StandardCharsets.UTF_8);
label.setText(text);

为什么FXML中特殊字符正常？ #

JavaFX加载FXML时，内部默认以UTF-8编码解析文件内容，因此硬编码的特殊字符能正确显示；而Java代码中的字符串如果编译时编码不匹配，会导致字符被错误转码，运行时显示乱码。

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