MacOS下JavaFX HelloWorld程序仅显示蓝色Java图标，无法打开UI窗口问题求助

我仔细看了你的问题描述和代码细节，发现几个关键问题导致UI窗口无法正常显示，下面逐一给出修复方案：

1. 修正FXML文件的两处错误 #

你的Sample.fxml存在两个问题：

• 控制器包名不匹配：FXML里指定的fx:controller="com.cowsill.jfxapplication.Controller"和Main.java所在的com.me.jfxapplication包不一致，会导致FXMLLoader找不到控制器类；
• 命名空间缺失前缀：xmlns:fx="javafx.com/fxml"少了http://，会导致FXML解析失败。

修复后的Sample.fxml：

<?xml version="1.0" encoding="UTF-8"?>
<?import javafx.scene.layout.GridPane?>
<GridPane fx:controller="com.me.jfxapplication.Controller" xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10">
</GridPane>

2. 补充module-info.java的依赖模块 #

你的module-info.java里缺少了javafx.controls模块依赖——虽然你在VM参数中添加了这个模块，但模块化项目必须在module-info.java中显式声明所需模块，否则控件无法正常初始化。

修复后的module-info.java：

module com.me.jfxapplication {
    exports com.me.jfxapplication;
    requires javafx.base;
    requires javafx.fxml;
    requires javafx.graphics;
    requires javafx.controls; // 新增该依赖
}

3. 确保FXML资源路径正确并添加异常排查 #

确认Sample.fxml和Main.java在同一个包目录下（即src/com/me/jfxapplication/下同时存在这两个文件），同时可以在start方法中添加异常捕获，方便快速定位加载问题：

修改后的Main.java片段：

@Override
public void start(Stage primaryStage) {
    try {
        Parent root = FXMLLoader.load(getClass().getResource("Sample.fxml"));
        primaryStage.setTitle("Hello World");
        primaryStage.setScene(new Scene(root, 300, 275));
        primaryStage.show();
    } catch (Exception e) {
        e.printStackTrace(); // 打印异常信息，快速定位加载失败原因
    }
}

4. 修正命令行编译运行的命令 #

如果用命令行操作，需要确保路径和模块化运行格式正确。假设你的项目结构如下：

project-root/
└── src/
    ├── module-info.java
    └── com/
        └── me/
            └── jfxapplication/
                ├── Main.java
                ├── Sample.fxml
                └── Controller.java

切换到project-root目录后，执行以下命令：

# 编译代码到out目录
javac --module-path ~/Documents/javafx-sdk-11.0.2/lib/ --add-modules javafx.controls,javafx.fxml -d out src/module-info.java src/com/me/jfxapplication/*.java

# 运行程序（需将out目录加入模块路径）
java --module-path ~/Documents/javafx-sdk-11.0.2/lib/:out --module com.me.jfxapplication/com.me.jfxapplication.Main

完成以上修复后，重新运行程序，应该就能正常显示"Hello World"窗口了。如果还有问题，可以查看控制台的异常输出，进一步定位问题。

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