JavaFX安装配置教程详解

还在为JavaFX的安装配置烦恼吗？本文为你提供一份**JavaFX安装与配置全攻略**，助你轻松上手！由于JDK 11及更高版本已移除JavaFX，你需要手动安装配置。本文详细讲解如何从Gluon官网下载JavaFX SDK，并针对命令行、IntelliJ IDEA和Eclipse三种环境，提供配置模块路径(--module-path)和模块参数(--add-modules)的具体步骤。对于模块化项目，还将指导你如何在`module-info.java`中声明依赖。最后，通过一个简单的测试程序，验证你的JavaFX环境是否配置成功。掌握这些技巧，让你在现代Java环境中流畅使用JavaFX！

JavaFX需手动配置。从Gluon官网下载SDK并解压，通过命令行或IDE设置模块路径和模块参数，如--module-path和--add-modules，在module-info.java中声明依赖，最后用测试程序验证配置成功。

JavaFX 并不包含在标准的 Java 开发工具包（JDK）中，特别是在 JDK 11 及更高版本中被移除。如果你使用的是 JDK 11 或更新版本，并希望在 Java 项目中使用 JavaFX，需要手动安装和配置。以下是详细的步骤说明。

下载并安装 JavaFX SDK

从官方来源获取 JavaFX SDK：

• 访问 https://gluonhq.com/products/javafx/
• 根据你的操作系统（Windows、macOS、Linux）下载对应的 JavaFX SDK 压缩包（如 javafx-sdk-21.0.2.zip）
• 解压文件到一个固定目录，例如：C:\javafx-sdk-21.0.2（Windows）或 ~/javafx-sdk-21.0.2（macOS/Linux）

在项目中配置 JavaFX（以命令行和 IDE 为例）

JavaFX 需要通过模块路径（module-path）和模块参数（--add-modules）来启用。

• 假设你的 Java 源文件是 Main.java，位于当前目录
• 设置模块路径并添加 JavaFX 模块：

编译：

javac --module-path "C:\javafx-sdk-21.0.2\lib" --add-modules javafx.controls,javafx.fxml Main.java

运行：

java --module-path "C:\javafx-sdk-21.0.2\lib" --add-modules javafx.controls,javafx.fxml Main

• 打开项目设置（File → Project Structure）
• 在 Libraries 中添加 JavaFX SDK 的 lib 目录下的所有 .jar 文件
• 进入 Run/Debug Configurations，在 VM options 中添加：

--module-path "C:/javafx-sdk-21.0.2/lib" --add-modules javafx.controls,javafx.fxml

• 右键项目 → Properties → Java Build Path → Modulepath → Add External JARs
• 选择 JavaFX SDK lib 目录下的所有 .jar 文件
• 在 Run Configuration 的 Arguments 标签页中，VM arguments 添加：

--module-path "C:/javafx-sdk-21.0.2/lib" --add-modules javafx.controls,javafx.fxml

处理模块化项目（module-info.java）

如果你的项目使用了 module-info.java，需在其中声明依赖：

module your.module.name {
    requires javafx.controls;
    requires javafx.fxml;

    opens your.package.name to javafx.fxml; // 如果使用 FXML
    exports your.package.name;
}

这样 JavaFX 运行时能正确访问控制器类。

验证是否配置成功

创建一个简单的测试程序：

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.stage.Stage;

public class TestFX extends Application {
    public static void main(String[] args) {
        launch(args);
    }

    @Override
    public void start(Stage stage) {
        Label label = new Label("JavaFX 已成功运行！");
        Scene scene = new Scene(label, 200, 100);
        stage.setScene(scene);
        stage.setTitle("测试");
        stage.show();
    }
}

如果窗口弹出并显示文字，说明配置成功。

基本上就这些。只要正确设置模块路径并加载所需模块，JavaFX 就能在现代 Java 环境中顺利运行。不复杂但容易忽略细节，尤其是路径和模块名拼写。

今天关于《JavaFX安装配置教程详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！