Ubuntu下Java图形界面开发入门与实践指南

时间：2026-08-21 | 作者：极客少年 | 阅读：0

Ubuntu Ja va图形界面开发指南

想在Ubuntu上进行Ja va图形界面开发，先把环境搭好。

这份指南从JDK安装讲起，再到IDE选择，最后演示Ja vaFX和Swing两种框架的基础开发流程，帮助你更顺畅地上手。

1. 安装Ja va开发环境（JDK）

在Ubuntu上做Ja va图形界面开发，第一步是安装JDK（Ja va Development Kit）。

推荐使用OpenJDK。它开源免费，兼容性也比较可靠。打开终端后，执行下面的命令安装OpenJDK 11。想使用更高版本也可以，Ja vaFX支持通常会更好。

sudo apt update
sudo apt install openjdk-11-jdk

安装完成后，建议先验证是否成功：

ja va -version   # 查看Ja va运行时版本
ja vac -version  # 查看Ja va编译器版本

如果看到类似openjdk version "11.0.xx"的输出，说明JDK已经安装完成。

2. 配置Ja va环境变量（可选但推荐）

如果你希望在任意路径下直接使用ja va或ja vac，建议配置JA VA_HOME环境变量。

先编辑~/.bashrc文件。这是用户级别配置，不会影响系统中的其他用户。

nano ~/.bashrc

在文件末尾添加以下内容。JDK安装路径可能会因版本不同略有差异，请以实际路径为准：

export JA VA_HOME=/usr/lib/jvm/ja va-11-openjdk-amd64   # OpenJDK 11默认路径
export PATH=$JA VA_HOME/bin:$PATH

保存后执行source ~/.bashrc使配置生效。

然后用echo $JA VA_HOME检查一下，确认路径是否正确。

3. 选择并安装集成开发环境（IDE）

编写图形界面代码时，一个顺手的IDE能明显提升效率。

下面两款工具比较主流：

IntelliJ IDEA：功能全面，对Ja vaFX和Swing的可视化设计、代码补全支持都比较完善。从JetBrains官网下载Linux版，解压后运行./bin/idea.sh即可启动。
Eclipse：开源免费，安装SWT、JFace等插件后，也可以进行图形界面开发。从Eclipse官网下载“Eclipse IDE for Ja va Developers”，解压后直接运行eclipse可执行文件即可。

4. Ja vaFX开发指南（现代推荐框架）

Ja vaFX适合现代桌面应用开发。

它支持CSS样式、FXML布局和动画效果，适合构建富客户端应用。如果你更看重现代化能力，可以优先选择它。

4.1 安装Ja vaFX SDK

从JDK 11开始，Ja vaFX不再内置在JDK中，需要单独下载。

你可以前往Gluon官网下载对应Linux版本的Ja vaFX SDK。版本需要和JDK匹配，比如JDK 11通常搭配Ja vaFX 11或17。下载后将其解压到某个目录，例如~/ja vafx-sdk-17。

4.2 配置Ja vaFX环境变量

编辑~/.bashrc，加入Ja vaFX库路径：

export PATH_TO_FX=~/ja vafx-sdk-17/lib   # 换成你实际解压的路径

接着执行source ~/.bashrc，让配置立即生效。

4.3 编写并运行Ja vaFX程序

下面创建一个简单的Ja vaFX程序，例如HelloJa vaFX.ja va：

import ja vafx.application.Application;
import ja vafx.scene.Scene;
import ja vafx.scene.control.Label;
import ja vafx.scene.layout.StackPane;
import ja vafx.stage.Stage;

public class HelloJa vaFX extends Application {
    @Override
    public void start(Stage primaryStage) {
        Label label = new Label("Hello, Ja vaFX!");
        StackPane root = new StackPane(label);
        Scene scene = new Scene(root, 400, 300);
        primaryStage.setTitle("Ja vaFX First App");
        primaryStage.setScene(scene);
        primaryStage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

编译和运行时，需要额外指定Ja vaFX模块路径：

ja vac --module-path $PATH_TO_FX --add-modules ja vafx.controls HelloJa vaFX.ja va
ja va --module-path $PATH_TO_FX --add-modules ja vafx.controls HelloJa vaFX

运行成功后，会弹出一个窗口，并显示“Hello, Ja vaFX!”。

5. Swing开发指南（传统框架）

Swing是Ja va的传统图形界面库，特点是轻量、兼容性好。

不过，它的界面风格相对复古，更适合不强调复杂视觉效果的桌面小工具。

5.1 编写并运行Swing程序

下面创建一个简单的Swing程序，例如HelloSwing.ja va：

import ja vax.swing.*;

public class HelloSwing {
    public static void main(String[] args) {
        // 确保GUI操作在事件调度线程（EDT）中执行
        SwingUtilities.invokeLater(() -> {
            JFrame frame = new JFrame("Hello Swing");
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setSize(300, 200);
            frame.setLocationRelativeTo(null); // 居中显示
            JLabel label = new JLabel("Hello, Swing!", JLabel.CENTER);
            frame.getContentPane().add(label);
            frame.setVisible(true);
        });
    }
}

它的编译和运行方式比较直接：

ja vac HelloSwing.ja va
ja va HelloSwing

运行后，同样会弹出一个窗口，显示“Hello, Swing!”。

6. 常见问题解决

Ja vaFX模块未找到：编译和运行时务必加上--add-modules ja vafx.controls。如果需要其他模块，比如ja vafx.fxml，也要一并添加。同时通过--module-path指定Ja vaFX库路径。
Swing窗口不显示：检查是否在事件调度线程（EDT）中创建和显示GUI组件。建议使用SwingUtilities.invokeLater进行包裹。
IDE无法识别Ja vaFX：IntelliJ IDEA里，通过“File → Project Structure → Libraries”添加Ja vaFX SDK；Eclipse里需要安装“e(fx)clipse”插件。