在 Ubuntu 上使用 Ja va 图形界面的完整步骤
一 环境准备
万事开头先搭台。想在 Ubuntu 上玩转 Ja va GUI，第一步就是把 Ja va 环境准备好。这里推荐 OpenJDK，社区活跃，与 Ubuntu 的集成度也高。对于大多数 GUI 应用来说，OpenJDK 11 是个稳妥的起点；当然，如果你有特定需求，把版本号换成 8、17 或 21 也完全没问题。
具体操作很简单，打开终端，依次执行：
- 安装运行时与开发包：如果你想一次性搞定运行和编译环境，这条命令最省心：
sudo apt update && sudo apt install -y default-jre default-jdk - 或仅安装 JDK：如果你明确只需要开发工具包，可以更精确地安装：
sudo apt install -y openjdk-11-jdk
安装完成后，别忘了验证一下。分别在终端输入 ja va -version 和 ja vac -version，如果都能正确返回版本号且没有报错，恭喜你，基础环境就位了。
二 运行或开发 Ja va GUI 的两种方式
环境有了，接下来就是选择“武器”。Ja va 图形界面主要有两大“门派”：经典内置的 Swing/AWT 和现代感更强的 Ja vaFX。
使用 Swing/AWT（内置无需额外依赖）
这是 Ja va 自带的“标准配置”，最大的优点就是开箱即用，无需任何额外依赖。举个例子，下面这段代码就能创建一个简单的窗口：
import ja vax.swing.*;
public class HelloSwing {
public static void main(String[] args) {
JFrame f = new JFrame(“Hello Swing”);
f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
f.setSize(300, 200);
f.setLocationRelativeTo(null);
f.add(new JLabel(“Hello, Swing!”, SwingConstants.CENTER));
f.setVisible(true);
}
}保存为 HelloSwing.ja va 后，编译和运行就两步：
ja vac HelloSwing.ja va
ja va HelloSwing一个写着“Hello, Swing!”的窗口就会弹出来，简单直接。
使用 Ja vaFX（需单独 SDK）
如果你追求更炫酷的界面和现代化的特性，Ja vaFX 是更好的选择。不过，它需要单独准备 SDK。
首先，去 Gluon 官网下载对应版本的 Ja vaFX SDK，解压到一个固定目录，比如 /opt/ja vafx-sdk-VERSION。
接下来的编译运行，有两种常用方式：
- 命令行指定模块与库：这是最清晰的方式，需要告诉编译器 Ja vaFX 库在哪，以及需要哪些模块。
ja vac --module-path $PATH_TO_FX --add-modules ja vafx.controls,ja vafx.fxml HelloFX.ja va ja va --module-path $PATH_TO_FX --add-modules ja vafx.controls,ja vafx.fxml HelloFX - 或在代码中通过 VM 参数传入：另一种方式是通过系统属性来设置。
ja va -Dja vafx.graphics.headless=false -Dja vafx.embedded=true -cp “$PATH_TO_FX/lib/*:.” HelloFX
这里有个关键提示：如果你使用的是 JDK 11 及以上版本，并且没有将 Ja vaFX 打包进你的应用，那么在运行时必须通过 --module-path 参数显式地提供 Ja vaFX 模块路径，否则程序会找不到相关的类。
三 远程或服务器环境的关键设置
很多时候，我们的开发环境是在没有显示器的服务器上，或者需要通过 SSH 远程连接。这时候运行 GUI 程序，就需要一点额外的配置。
核心在于确保有一个 X11 显示服务器。如果你是通过 SSH 远程开发，记得在连接时启用 X11 转发：
ssh -X user@host如果你已经在本地或一个有桌面会话的环境中，可以先确认一下 DISPLAY 环境变量：
echo $DISPLAY输出通常是 :0 或 :1。
遇到问题别慌，看看下面这些常见报错和处理思路：
- 报错
“No X11 DISPLAY variable was set …”：这说明系统没找到显示设备。解决方法就是启用 SSH 的 X11 转发，或者手动设置DISPLAY环境变量。 - 报错
“Can’t connect to X11 window server …”：这通常是连接或权限问题。检查DISPLAY设置是否正确，确认 X11 服务是否在运行。有时可能需要调整权限（比如谨慎使用xhost +命令来允许远程连接）。
四 常见问题与快速排查
最后，我们来盘点几个可能会踩到的坑，以及快速排查的方法：
- 命令未找到或版本不对：首先确认安装的是 JDK（Ja va Development Kit）而不仅仅是 JRE（Ja va Runtime Environment）。用
ja va -version和ja vac -version双重校验一下。 - Ja vaFX 找不到模块：检查
--module-path指向的路径是否正确（应该是 Ja vaFX SDK 的 lib 目录），并且确认--add-modules参数里添加了所有必需的模块（比如ja vafx.controls, ja vafx.fxml）。 - 运行缓慢或界面卡顿：在缺乏 GPU 加速的无头服务器或虚拟环境中，界面渲染可能会变慢。可以尝试启用软件渲染模式（例如添加VM参数
-Dprism.order=sw），或者在设计界面时考虑使用更轻量级的布局和控件。 - 多版本 Ja va 并存：系统里装了多个 Ja va 版本是常事。可以使用
update-alternatives命令来切换默认的ja va/ja vac。更推荐的做法是在你的项目脚本或 IDE 设置中，显式地指定JA VA_HOME和PATH，确保使用正确的版本。
