在 Debian 上做 Java 图形界面开发，常见卡点通常不在代码本身，而在系统环境是否完整：Java 装的是不是合适版本、系统有没有桌面环境、JavaFX 的模块路径有没有配对。下面按“先把系统跑通，再把示例窗口跑起来”的顺序梳理一遍，读完你可以直接判断自己该装 `default-jdk`、还是继续补 GNOME、OpenJFX 这类依赖。
先更新软件包并安装 Java
开始前先刷新 Debian 的软件包索引，避免后续安装时拿到过期元数据：
sudo apt updateJava 运行环境建议直接使用 OpenJDK。原文提到的主流版本是 Java 11 和 17；如果你只是想先把开发环境搭起来，通常装 JDK 比只装 JRE 更省事。
OpenJDK 11 或默认 JDK 怎么选
可用的安装方式有两种：
- 安装 OpenJDK 11：
sudo apt install openjdk-11-jdk - 安装系统默认 JDK：
sudo apt install default-jdk
装完后，先用下面的命令确认 Java 已经可用：
java -version只要能正常输出版本信息，说明 Java 基础环境已经就绪。
是否需要配置 JAVA_HOME
如果你只是临时编译和运行一个示例程序，这一步可以先跳过；但只要后面还要接 IDE、构建工具或脚本，最好把 JAVA_HOME 配好。
编辑系统环境文件：
sudo nano /etc/environment然后在文件末尾追加一行。以 Java 11 为例，原文给出的路径是：
JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"保存后执行：
source /etc/environment需要注意的是，JAVA_HOME 的值必须和你机器上实际安装的 JDK 路径一致。如果你安装的是 default-jdk，目录名可能与示例不同，配置前最好先核对。
没有桌面环境时，先补齐图形界面
想运行 Swing 或 JavaFX 程序，前提是系统本身具备图形桌面。原文给出的示例是安装 GNOME：
- 更新软件包列表：
sudo apt update - 安装 GNOME 桌面环境及必要组件：
sudo apt install ubuntu-gnome-desktop - 安装过程中如果系统提示选择默认显示管理器，推荐选择
gdm3
这一步的核心判断标准很简单：如果你的 Debian 还停留在纯终端环境，那么 Java 代码写得再完整，也不会直接弹出图形窗口，必须先让系统具备桌面会话和显示管理器。
把系统默认启动目标切到图形模式
桌面环境装好后，还需要让系统默认进入图形目标：
sudo systemctl set-default graphical.target然后重启系统：
sudo reboot重启后如果能看到图形登录界面，说明 Debian 端的 GUI 基础已经打通，接下来就可以验证 Java 图形程序本身。
先用 Swing，再看 JavaFX
在 Java 图形界面方案里，Swing 依赖最少，适合先确认环境是否正常；JavaFX 更现代，但需要额外处理 SDK 和模块参数。
Swing 示例：先确认窗口能不能正常弹出
import javax.swing.*;
public class SimpleSwingApp {
public static void main(String[] args) {
JFrame frame = new JFrame("Simple Swing App");
frame.setSize(300, 200);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setLocationRelativeTo(null); // 居中显示
JLabel label = new JLabel("Hello, Swing!", JLabel.CENTER);
frame.getContentPane().add(label);
frame.setVisible(true);
}
}这个示例只有一个窗口和一段文本，非常适合用来做最小化验证：如果它能运行，说明 Java、本地图形环境和基础窗口显示链路都没问题。
JavaFX 示例：代码更现代，但要额外装 SDK
import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Label;
import javafx.scene.layout.StackPane;
import javafx.stage.Stage;
public class SimpleJavaFXApp extends Application {
@Override
public void start(Stage primaryStage) {
primaryStage.setTitle("Simple JavaFX App");
Label label = new Label("Hello, JavaFX!");
StackPane root = new StackPane();
root.getChildren().add(label);
primaryStage.setScene(new Scene(root, 300, 250));
primaryStage.show();
}
public static void main(String[] args) {
launch(args);
}
}和 Swing 不同，JavaFX 示例依赖额外的 JavaFX SDK。也就是说，代码本身写完后，还得确保模块路径和模块名在编译、运行时都带上。
编译与运行：Swing 直接跑，JavaFX 需要模块参数
Swing 的编译和运行命令
Swing 不需要额外依赖，直接编译运行即可：
javac SimpleSwingApp.java
java SimpleSwingAppJavaFX 的编译和运行命令
原文建议先从 OpenJFX 官网下载对应版本的 SDK，例如 javafx-sdk-21。之后再通过 --module-path 和 --add-modules 指定依赖：
javac --module-path /path/to/javafx-sdk-21/lib --add-modules javafx.controls SimpleJavaFXApp.javajava --module-path /path/to/javafx-sdk-21/lib --add-modules javafx.controls SimpleJavaFXApp这里最容易出错的地方有两个：一是 SDK 路径写错，二是模块名漏写。只要这两项对不上，JavaFX 程序通常就无法正常编译或启动。
常见问题怎么排查
1. 系统无法进入图形界面
如果重启后还是没有进入图形界面，先检查 gdm3 是否正常运行：
sudo systemctl status gdm3如果没有启动，可以手动拉起：
sudo service gdm3 start还不行的话，可以按原文给出的方式重新安装桌面环境：
sudo apt install --reinstall ubuntu-gnome-desktop2. JavaFX 提示找不到模块
这类问题重点检查两件事：
--module-path是否准确指向 JavaFX SDK 的lib目录--add-modules是否包含实际需要的模块，例如javafx.controls、javafx.fxml
如果 Swing 能正常运行，而 JavaFX 报模块错误，通常说明 Debian 的图形环境本身没问题，问题集中在 JavaFX SDK 路径或参数配置上。
一套更稳妥的验证顺序
如果你是第一次在 Debian 上折腾 Java 图形界面，建议按这个顺序做验证：先执行 sudo apt update，再安装 openjdk-11-jdk 或 default-jdk，用 java -version 确认 Java 可用；之后检查系统是否已有桌面环境，没有就安装 GNOME 并切到 graphical.target；最后先跑 Swing，再处理 JavaFX 的 SDK 和模块参数。这样一层层排除，比一上来就调 JavaFX 报错要高效得多。
