如何构建类似Scene Builder的JavaFX多模块项目并解决IDEA配置难题？

模块职责定义 #

• kit模块：作为核心工具库，封装JavaFX通用组件、样式、工具类等，仅提供可复用基础能力，不包含业务逻辑，对标Scene Builder的kit模块定位。
• app模块：应用入口，依赖kit模块，实现具体业务逻辑与界面组装，包含项目主类（Main类），负责启动JavaFX应用。
• 根目录src/：可选存放跨模块共享资源或通用配置，若无需跨模块共享可直接删除。

模块依赖配置（Maven） #

根pom.xml配置 #

将根pom设置为聚合工程，声明子模块：

<modules>
    <module>kit</module>
    <module>app</module>
</modules>

kit模块pom.xml配置 #

配置为普通Java库模块，引入所需JavaFX基础依赖：

<dependencies>
    <dependency>
        <groupId>org.openjfx</groupId>
        <artifactId>javafx-controls</artifactId>
        <version>21</version> <!-- 替换为你的JavaFX版本 -->
    </dependency>
    <!-- 按需添加javafx-fxml、javafx-graphics等其他模块 -->
</dependencies>

app模块pom.xml配置 #

添加对kit模块的依赖，同时配置JavaFX插件指定主类：

<dependencies>
    <dependency>
        <groupId>你的项目groupId</groupId>
        <artifactId>kit</artifactId>
        <version>1.0-SNAPSHOT</version> <!-- 与kit模块版本保持一致 -->
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.openjfx</groupId>
            <artifactId>javafx-maven-plugin</artifactId>
            <version>0.0.8</version>
            <configuration>
                <mainClass>com.yourpackage.app.Main</mainClass> <!-- 替换为app模块主类的完整路径 -->
            </configuration>
        </plugin>
    </plugins>
</build>

IntelliJ IDEA运行配置设置 #

方式1：通过Maven插件运行 #

1. 打开Run/Debug Configurations，点击+选择Maven。
2. Working directory选择app模块的根目录。
3. Command line输入javafx:run，保存配置后即可运行。

方式2：直接配置Java Application #

1. 打开Run/Debug Configurations，点击+选择Java Application。
2. Main class选择app模块中的主类（需继承Application并实现start()方法）。
3. 在Module下拉框中选择app模块，确保类路径包含kit模块。
4. 若出现类找不到的问题，检查Project Structure -> Modules -> app -> Dependencies，确认已添加kit模块为依赖。

模块化Java注意事项（可选） #

如果使用模块化Java，需正确配置各模块的module-info.java：

• kit模块的module-info.java：

module kit {
    exports com.yourpackage.kit; // 导出供app模块使用的包
    requires javafx.controls;
}

• app模块的module-info.java：

module app {
    requires kit;
    requires javafx.controls;
    opens com.yourpackage.app to javafx.fxml; // 若使用FXML需打开对应包
    exports com.yourpackage.app;
}

若无需模块化，可直接删除所有module-info.java文件，保持传统Maven依赖结构。

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