M1 Pro芯片MacBook在Eclipse中运行JavaFX项目遇异常

核心修复步骤 #

1. 校验JavaFX SDK与JDK的架构&版本匹配 #

M1 Pro是arm64架构，必须下载arm64版本的JavaFX SDK，同时确保SDK版本和Eclipse使用的JDK版本完全对齐（比如JDK17配JavaFX17.x，JDK21配JavaFX21.x），x86版本的SDK在M1上会导致兼容问题。

2. 补全运行配置的VM参数 #

仅配置Modulepath不够，必须手动添加VM参数：

• 打开Eclipse的「Run Configurations」，选中你的JavaFX项目
• 切换到「Arguments」标签，在「VM arguments」中填入：

  --module-path /你的JavaFXSDK路径/lib --add-modules javafx.controls,javafx.fxml
  

  把/你的JavaFXSDK路径/lib替换成你本地JavaFX SDK lib目录的绝对路径（比如/Users/xxx/Documents/javafx-sdk-21/lib）

3. 修正模块配置文件 #

检查项目根目录的module-info.java，确保内容正确：

module 你的模块名 {
    requires javafx.controls;
    requires javafx.fxml;
    opens 你的包名 to javafx.fxml;
    exports 你的包名;
}

同时在项目属性的「Java Build Path」→「Modules」里，确认已将javafx.controls和javafx.fxml设为依赖模块。

4. 确认Eclipse使用arm64版JDK #

打开Eclipse偏好设置「Java」→「Installed JREs」，确保选中的是arm64架构的JDK（比如Azul Zulu的arm64版本），不要用x86版JDK通过Rosetta模拟运行，这会导致JavaFX界面渲染异常。

5. 清理重建项目 #

• 执行「Project」→「Clean...」清理项目缓存
• 右键项目选择「Refresh」，然后重新编译运行

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