首先下载JavaFX SDK并解压到固定目录,然后在IntelliJ IDEA中添加lib文件夹下的所有JAR依赖,接着在运行配置中设置--module-path和--add-modules VM参数,最后通过运行HelloFX测试程序验证环境是否成功搭建。

要在Java中使用JavaFX进行开发,需要正确安装和配置JavaFX环境。由于从JDK 11开始,JavaFX已不再包含在JDK中,因此必须手动引入JavaFX SDK并配置到项目中。以下是详细的搭建步骤和经验分享。
下载JavaFX SDK
访问Gluon官网下载最新版本的JavaFX SDK。选择与你操作系统匹配的版本(Windows、macOS或Linux)。下载完成后解压到一个固定目录,例如:C:\javafx-sdk-21 或 /opt/javafx-sdk-21。
配置IDE中的JavaFX依赖
以IntelliJ IDEA为例说明如何配置:
- 创建一个新的Java项目
- 进入Project Structure → Modules → Dependencies
- 点击“+”号,选择“JARs or directories”
- 添加解压后的JavaFX SDK中lib文件夹下的所有JAR文件
确保这些库被正确加载,特别是javafx.controls和javafx.fxml等核心模块。
立即学习“Java免费学习笔记(深入)”;
设置VM参数启用JavaFX
JavaFX运行时需要通过JVM参数显式启用模块系统。在运行配置中添加以下VM选项:
注意:路径需根据实际SDK位置修改,使用正斜杠或双反斜杠避免转义问题。如果使用的是Mac或Linux,路径格式类似:/Users/name/javafx-sdk-21/lib。
验证环境是否配置成功
编写一个简单的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 HelloFX extends Application {
@Override
public void start(Stage stage) {
Button btn = new Button("Hello JavaFX");
StackPane root = new StackPane();
root.getChildren().add(btn);
stage.setScene(new Scene(root, 300, 200));
stage.setTitle("Test");
stage.show();
}
public static void main(String[] args) {
launch(args);
}
}
运行该程序,如果弹出窗口并显示按钮,则说明JavaFX环境已成功搭建。
基本上就这些。只要确保SDK路径正确、模块参数无误、依赖导入完整,JavaFX就能正常运行。不复杂但容易忽略细节。










