首页 > 文章 > java教程

JavaFX环境搭建教程：GUI开发配置指南

时间：2026-01-23 10:20:30 412浏览收藏

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《JavaFX环境搭建教程：JavaGUI开发配置指南》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

要配置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开发环境_JavaGUI项目环境搭建方法

要在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模块：

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

注意：路径使用双引号包裹，模块根据实际使用情况添加，常见模块包括：javafx.controls、javafx.fxml、javafx.graphics等。

使用Maven或Gradle管理JavaFX依赖（推荐）

现代Java项目建议使用构建工具自动管理JavaFX依赖。

Maven配置示例：

    org.openjfx
    javafx-controls
    21


    org.openjfx
    javafx-fxml
    21

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方式管理依赖，减少配置错误。

以上就是《JavaFX环境搭建教程：GUI开发配置指南》的详细内容，更多关于的资料请关注golang学习网公众号！

前往漫画官网入口并下载 ➜