运行Java图形程序需正确配置JDK并编写Swing测试代码。确认安装JDK、设置JAVA_HOME、确保java和javac可用，编写HelloGUI.java程序，编译后运行java HelloGUI，若弹出窗口则成功。
直接在命令行中测试 Java 是否支持 GUI 程序，关键不是单独验证“GUI 支持”，而是确认 JDK 完整安装且图形子系统可用。Java 的 Swing 和 JavaFX 都内建于标准 JDK 中，只要 JDK 正确配置，GUI 程序就能运行——前提是系统有图形环境（如 Windows 桌面、macOS 图形会话、Linux 已启动 X11/Wayland 且 DISPLAY 变量有效）。
第一步：确认 JDK 安装与基础环境
打开命令行，依次执行以下命令：
-
java -version —— 检查 JRE 运行时是否就绪，应输出类似
java version "17.0.8"的信息 - javac -version —— 确认 JDK 编译器可用，排除仅装了 JRE 的情况
-
echo $JAVA_HOME（Linux/macOS）或 echo %JAVA_HOME%（Windows）—— 确保变量指向 JDK 根目录（如
/usr/lib/jvm/java-17-openjdk-amd64），而非 JRE
第二步：编写并运行一个最小 Swing 窗口程序
这是最可靠的 GUI 支持实测方式。新建文件 HelloGUI.java，内容如下：
import javax.swing.JFrame;
public class HelloGUI {
public static void main(String[] args) {
JFrame frame = new JFrame("GUI Test");
frame.setSize(250, 150);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setVisible(true);
}
}
立即学习“Java免费学习笔记（深入）”；
然后在该文件所在目录执行：
- javac HelloGUI.java —— 编译成功无报错
- java HelloGUI —— 若弹出标题为 “GUI Test” 的窗口，即表示 GUI 支持完全正常
第三步：Linux 用户需额外检查显示环境
在纯命令行（如 SSH 登录、无桌面的服务器）下，即使 JDK 完整，java HelloGUI 也会报错：java.awt.HeadlessException 或 No X11 DISPLAY variable。此时需确认：
- 当前是否处于图形会话中（例如本地终端，非远程 SSH）
- 运行 echo $DISPLAY，正常应输出类似
:0或localhost:10.0 - 若通过 SSH 连接，可加 -X 或 -Y 参数启用 X11 转发（需服务端开启 X11Forwarding）
常见失败原因与对应提示
如果窗口未弹出，注意控制台输出：
- 出现
Exception in thread "main" java.awt.HeadlessException→ 系统处于 headless 模式，缺少图形显示支持 - 报错
Could not find or load main class HelloGUI→ 类名/文件名不匹配，或未在正确目录执行java - 编译时报
package javax.swing does not exist→ 使用了精简版 JRE 或非标准 JDK（如某些 Alpine Linux 的 openjdk-jre），需换用完整 JDK
