JavaFX安装配置全攻略详解

还在为JavaFX的安装配置烦恼吗？本教程为你提供**JavaFX安装与配置教程详解**，手把手教你搞定！由于JDK 11及更高版本移除了JavaFX，你需要手动配置。首先，从Gluon官网下载JavaFX SDK并解压。然后，通过命令行或IDE设置模块路径和模块参数，例如`--module-path`和`--add-modules`。如果你的项目是模块化项目，需要在`module-info.java`中声明依赖。最后，通过运行一个简单的测试程序，验证JavaFX是否配置成功。详细步骤和示例代码，助你轻松掌握JavaFX配置，让你的Java项目焕发新生！不再为繁琐的配置而苦恼，快来学习吧！

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学习网公众号，带你了解更多关于的知识点！