要配置JavaFX开发环境，需手动下载并引入JavaFX SDK。从JDK 11起，JavaFX不再内置，需访问Gluon官网下载对应系统的SDK并解压。在IntelliJ IDEA中创建Java项目后，通过Project Structure添加JavaFX的lib目录为库依赖，并在运行配置中设置VM选项：--module-path 和 --add-modules 指定路径与模块。推荐使用Maven或Gradle自动管理依赖，如Maven添加org.openjfx:javafx-controls和javafx-fxml依赖，Gradle使用implementation引入。最后编写测试程序验证，若成功弹出含按钮的窗口则配置完成。优先采用构建工具以减少手动配置错误。
要在Java中使用JavaFX进行GUI开发，需要正确安装和配置JavaFX环境。由于从JDK 11开始，JavaFX已不再包含在JDK中，必须手动引入。以下是详细的JavaFX开发环境搭建方法。
下载并配置JavaFX SDK
JavaFX以独立SDK的形式提供，需从官方渠道获取并配置到项目中。
- 访问 https://gluonhq.com/products/javafx/ 下载对应操作系统的JavaFX SDK（如：Windows、macOS、Linux）
- 解压下载的ZIP文件到一个固定目录，例如：C:\javafx-sdk-21 或 /usr/lib/javafx-sdk-21
- 记住该路径，后续在IDE或命令行中需要引用
在IntelliJ IDEA中配置JavaFX项目
IntelliJ IDEA是常用的Java开发工具，配置JavaFX步骤如下：
- 创建一个新的Java项目
- 进入 File → Project Structure → Libraries，点击“+”号添加JavaFX SDK中的lib目录（即
javafx-sdk-21/lib） - 确保模块依赖中已包含JavaFX库
- 在运行配置中添加VM选项，启用JavaFX模块：
注意：路径使用双引号包裹，模块根据实际使用情况添加，常见模块包括：javafx.controls、javafx.fxml、javafx.graphics等。
立即学习“Java免费学习笔记（深入）”；
使用Maven或Gradle管理JavaFX依赖（推荐）
现代Java项目建议使用构建工具自动管理JavaFX依赖。
Maven配置示例： <dependencies>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>21</version>
</dependency>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-fxml</artifactId>
<version>21</version>
</dependency>
</dependencies> Gradle配置示例： implementation 'org.openjfx:javafx-controls:21'
implementation 'org.openjfx:javafx-fxml:21'
使用构建工具后，无需手动设置模块路径，IDE会自动处理。
编写并运行JavaFX程序测试环境
创建一个简单的JavaFX应用验证配置是否成功：
import javafx.application.Application;import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
public class HelloJavaFX extends Application {
@Override
public void start(Stage stage) {
Button btn = new Button("点击我");
btn.setOnAction(e -> System.out.println("Hello JavaFX!"));
Scene scene = new Scene(new StackPane(btn), 300, 200);
stage.setTitle("JavaFX 测试");
stage.setScene(scene);
stage.show();
}
public static void main(String[] args) {
launch(args);
}
}
运行该程序，若弹出窗口并显示按钮，则说明JavaFX环境配置成功。
基本上就这些。只要正确引入JavaFX库并设置模块参数，就能顺利开始JavaGUI项目开发。不复杂但容易忽略细节，尤其是路径和模块名的拼写。建议优先使用Maven或Gradle方式管理依赖，减少配置错误。
