JavaFX GUI文本显示异常（仅标题正常），Eclipse外观设置调整无效

• 匹配JavaFX与JDK版本：确保使用的JavaFX版本和JDK版本完全兼容，比如JDK 11对应JavaFX 11，JDK 17对应JavaFX 17，版本不匹配易引发渲染异常。
• 强制指定界面字体：
  • 代码中直接设置全局字体：

    import javafx.scene.text.Font;
    // 在初始化根节点后设置
    root.setFont(Font.font("Microsoft YaHei", 12));
    

  • 或通过CSS样式表设置：
    创建styles.css文件，内容如下：

    .root {
        -fx-font-family: "Microsoft YaHei";
        -fx-font-size: 12px;
    }
    

    然后在代码中引入样式表：

    scene.getStylesheets().add(getClass().getResource("styles.css").toExternalForm());
    

• 调整Eclipse运行VM参数：
  打开Run Configurations，在对应的JavaFX运行配置的VM参数中添加：

  --module-path "你的JavaFX库绝对路径" --add-modules javafx.controls,javafx.fxml
  -Dprism.lcdtext=false
  -Dprism.text=t2k
  

  这两个Prism参数可强制JavaFX切换文本渲染引擎，解决字体错乱问题。
• 检查系统字体完整性：确保系统中安装有常用中文字体（如微软雅黑、宋体），缺失字体可能导致JavaFX无法正常渲染文本。
• 清理Eclipse缓存：关闭Eclipse，删除工作区目录下的.metadata文件夹（操作前备份重要配置），重启Eclipse后重新导入项目，排除缓存引发的配置异常。
• 交叉验证开发环境：尝试用IntelliJ IDEA打开项目并运行，若问题消失则说明是Eclipse的配置问题，可考虑重置Eclipse的JavaFX相关偏好设置。

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