Java GUI 开发教程：从 Swing 到 JavaFX 的完整入门指南

TL;DR（摘要）：本文是一份面向初学者的 Java GUI 开发完整教程，系统讲解 Swing 与 JavaFX 两大主流框架。你将学到：Swing 的窗口创建、常用组件、事件处理与布局管理，并动手实现一个完整的登录界面；随后入门 JavaFX，了解其现代化组件、CSS 样式与 FXML 界面分离模式。文末还提供两大框架的对比总结、常见问题调试技巧与进阶学习方向，帮助你快速上手桌面应用开发。

目录

• 1. 引言
• 2. Java GUI 开发概述
  • 2.1 什么是 GUI
  • 2.2 Java 主流 GUI 框架对比
  • 2.3 如何选择
• 3. 开发环境准备
  • 3.1 安装 JDK
  • 3.2 选择 IDE
  • 3.3 创建项目
• 4. Swing 基础入门
  • 4.1 第一个 Swing 窗口
  • 4.2 常用组件
  • 4.3 事件处理机制
  • 4.4 布局管理器
• 5. Swing 实战：登录界面
• 6. JavaFX 入门
  • 6.1 JavaFX 简介
  • 6.2 第一个 JavaFX 应用
  • 6.3 使用 FXML 分离界面与逻辑
• 7. Swing 与 JavaFX 对比总结
• 8. 常见问题与调试技巧
  • 8.1 界面不显示
  • 8.2 中文乱码
  • 8.3 事件不响应
  • 8.4 线程问题
• 9. 进阶学习方向
• 10. 总结

1. 引言

Java 作为一门跨平台的高级编程语言，除了在服务端开发领域占据重要地位外，在桌面应用开发方面同样拥有成熟的技术体系。GUI（Graphical User Interface，图形用户界面）开发是 Java 应用开发中不可或缺的一部分，它让程序能够以直观、友好的方式与用户交互。

本教程将带你系统学习 Java GUI 开发，从最经典的 Swing 框架入手，逐步过渡到现代化的 JavaFX 平台。无论你是刚接触 Java 的初学者，还是希望拓展桌面开发技能的开发者，本文都能为你提供清晰的学习路径和实用的代码示例。

2. Java GUI 开发概述

2.1 什么是 GUI

GUI 即图形用户界面，是指采用图形方式显示的计算机操作用户界面。与早期的命令行界面（CLI）相比，GUI 允许用户通过鼠标点击、拖拽等直观操作与程序交互，大大降低了软件的使用门槛。

2.2 Java 主流 GUI 框架对比

Java 生态中主要有三个 GUI 工具包：

2.3 如何选择

对于初学者，建议从 Swing 入手，因为它的 API 简单直观，学习曲线平缓，能帮助你快速理解 GUI 编程的核心概念（事件模型、布局管理等）。当掌握基础后，再转向 JavaFX 学习更现代的 UI 开发方式。

3. 开发环境准备

3.1 安装 JDK

首先确保你的电脑上安装了 JDK 8 或更高版本。可以通过以下命令验证：

java -version

如果尚未安装，可以前往 Oracle 官网或使用 OpenJDK 发行版（如 Adoptium）进行安装。

3.2 选择 IDE

推荐使用以下集成开发环境：

• IntelliJ IDEA：功能强大，对 JavaFX 支持良好
• Eclipse：老牌 IDE，插件生态丰富
• VS Code：轻量级，配合 Java 扩展包使用

3.3 创建项目

以 IntelliJ IDEA 为例，新建 Java 项目后，在 src 目录下创建主类即可开始编写 GUI 代码。

4. Swing 基础入门

4.1 第一个 Swing 窗口

让我们从创建一个最简单的窗口开始：

import javax.swing.JFrame;

public class FirstWindow {
public static void main(String[] args) {
// 创建窗口对象
JFrame frame = new JFrame("我的第一个 Swing 窗口");

// 设置窗口大小（宽、高）
frame.setSize(400, 300);

// 设置关闭窗口时退出程序
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

// 让窗口居中显示
frame.setLocationRelativeTo(null);

// 显示窗口
frame.setVisible(true);
}
}

运行上述代码，你会看到一个标题为「我的第一个 Swing 窗口」的空白窗口。这是所有 Swing 应用的起点。

4.2 常用组件

Swing 提供了丰富的组件库，以下是几个最常用的：

import javax.swing.*;
import java.awt.FlowLayout;

public class BasicComponents {
public static void main(String[] args) {
JFrame frame = new JFrame("常用组件示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(400, 300);

// 设置布局管理器为流式布局
frame.setLayout(new FlowLayout());

// 标签组件
JLabel label = new JLabel("用户名：");

// 文本框组件
JTextField textField = new JTextField(15);

// 按钮组件
JButton button = new JButton("登录");

// 复选框组件
JCheckBox checkBox = new JCheckBox("记住我");

// 将组件添加到窗口
frame.add(label);
frame.add(textField);
frame.add(button);
frame.add(checkBox);

frame.setVisible(true);
}
}

4.3 事件处理机制

GUI 程序的核心在于事件驱动。当用户点击按钮、输入文字时，程序需要做出响应。Swing 采用监听器模式处理事件：

import javax.swing.*;
import java.awt.FlowLayout;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class EventDemo {
public static void main(String[] args) {
JFrame frame = new JFrame("事件处理示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(300, 200);
frame.setLayout(new FlowLayout());

JButton button = new JButton("点击我");
JLabel label = new JLabel("还没有点击");

// 为按钮添加事件监听器
button.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
label.setText("按钮被点击了！");
}
});

frame.add(button);
frame.add(label);
frame.setVisible(true);
}
}

4.4 布局管理器

布局管理器负责控制组件在容器中的排列方式。Swing 提供了多种布局：

• FlowLayout：从左到右排列，放不下自动换行
• BorderLayout：分为东南西北中五个区域
• GridLayout：网格状排列，所有单元格大小相同
• GridBagLayout：最灵活，但使用复杂

import javax.swing.*;
import java.awt.BorderLayout;

public class BorderLayoutDemo {
public static void main(String[] args) {
JFrame frame = new JFrame("边界布局示例");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setSize(400, 300);

// 设置边界布局
frame.setLayout(new BorderLayout());

// 在五个区域添加按钮
frame.add(new JButton("北"), BorderLayout.NORTH);
frame.add(new JButton("南"), BorderLayout.SOUTH);
frame.add(new JButton("东"), BorderLayout.EAST);
frame.add(new JButton("西"), BorderLayout.WEST);
frame.add(new JButton("中"), BorderLayout.CENTER);

frame.setVisible(true);
}
}

5. Swing 实战：登录界面

5.1 注册界面实战

掌握了登录界面的实现后，我们再来构建一个功能更完整的注册界面。它包含用户名、邮箱、密码、确认密码四个输入项和一个注册按钮，并在提交时进行密码强度校验（至少 8 位且同时包含字母和数字），校验失败会在界面中给出具体错误提示。

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class RegisterFrame extends JFrame {
private JTextField usernameField;
private JTextField emailField;
private JPasswordField passwordField;
private JPasswordField confirmPasswordField;
private JLabel messageLabel;

public RegisterFrame() {
// 设置窗口属性
setTitle("用户注册");
setSize(400, 300);
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
setLocationRelativeTo(null);
setResizable(false);

// 创建主面板
JPanel mainPanel = new JPanel(new GridBagLayout());
GridBagConstraints gbc = new GridBagConstraints();
gbc.insets = new Insets(5, 5, 5, 5);

// 用户名行
gbc.gridx = 0;
gbc.gridy = 0;
mainPanel.add(new JLabel("用户名："), gbc);

gbc.gridx = 1;
usernameField = new JTextField(15);
mainPanel.add(usernameField, gbc);

// 邮箱行
gbc.gridx = 0;
gbc.gridy = 1;
mainPanel.add(new JLabel("邮箱："), gbc);

gbc.gridx = 1;
emailField = new JTextField(15);
mainPanel.add(emailField, gbc);

// 密码行
gbc.gridx = 0;
gbc.gridy = 2;
mainPanel.add(new JLabel("密码："), gbc);

gbc.gridx = 1;
passwordField = new JPasswordField(15);
mainPanel.add(passwordField, gbc);

// 确认密码行
gbc.gridx = 0;
gbc.gridy = 3;
mainPanel.add(new JLabel("确认密码："), gbc);

gbc.gridx = 1;
confirmPasswordField = new JPasswordField(15);
mainPanel.add(confirmPasswordField, gbc);

// 按钮行
gbc.gridx = 0;
gbc.gridy = 4;
gbc.gridwidth = 2;
JPanel buttonPanel = new JPanel(new FlowLayout());
JButton registerButton = new JButton("注册");
JButton resetButton = new JButton("重置");
buttonPanel.add(registerButton);
buttonPanel.add(resetButton);
mainPanel.add(buttonPanel, gbc);

// 提示信息
gbc.gridy = 5;
messageLabel = new JLabel(" ");
messageLabel.setForeground(Color.RED);
mainPanel.add(messageLabel, gbc);

// 添加事件监听
registerButton.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
handleRegister();
}
});

resetButton.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
usernameField.setText("");
emailField.setText("");
passwordField.setText("");
confirmPasswordField.setText("");
messageLabel.setText(" ");
}
});

add(mainPanel);
}

private void handleRegister() {
String username = usernameField.getText().trim();
String email = emailField.getText().trim();
String password = new String(passwordField.getPassword());
String confirmPassword = new String(confirmPasswordField.getPassword());

// 校验用户名是否为空
if (username.isEmpty()) {
showError("用户名不能为空！");
return;
}

// 校验邮箱是否为空
if (email.isEmpty()) {
showError("邮箱不能为空！");
return;
}

// 校验邮箱格式（简单校验：必须包含 @ 和 .）
if (!email.contains("@") || !email.contains(".")) {
showError("邮箱格式不正确！");
return;
}

// 校验密码是否为空
if (password.isEmpty()) {
showError("密码不能为空！");
return;
}

// 校验密码强度：至少 8 位且包含字母和数字
String passwordError = checkPasswordStrength(password);
if (passwordError != null) {
showError(passwordError);
return;
}

// 校验两次密码是否一致
if (!password.equals(confirmPassword)) {
showError("两次输入的密码不一致！");
return;
}

// 所有校验通过，注册成功
messageLabel.setForeground(new Color(0, 128, 0));
messageLabel.setText("注册成功！欢迎 " + username);
}

/**
* 校验密码强度
* @return 返回错误信息；如果密码合法则返回 null
*/
private String checkPasswordStrength(String password) {
// 检查长度是否至少 8 位
if (password.length() < 8) {
return "密码长度至少为 8 位！";
}

// 检查是否包含字母
boolean hasLetter = false;
// 检查是否包含数字
boolean hasDigit = false;

for (char c : password.toCharArray()) {
if (Character.isLetter(c)) {
hasLetter = true;
} else if (Character.isDigit(c)) {
hasDigit = true;
}
}

if (!hasLetter) {
return "密码必须包含字母！";
}

if (!hasDigit) {
return "密码必须包含数字！";
}

// 密码合法
return null;
}

private void showError(String message) {
messageLabel.setForeground(Color.RED);
messageLabel.setText(message);
}

public static void main(String[] args) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
new RegisterFrame().setVisible(true);
}
});
}
}

运行上述代码，你会看到一个包含用户名、邮箱、密码和确认密码的注册窗口。点击「注册」按钮时，程序会依次校验输入内容：用户名和邮箱不能为空、邮箱格式必须合法、密码长度至少 8 位且同时包含字母和数字、两次密码必须一致。任何一项校验失败，都会在窗口底部显示具体的红色错误提示；全部通过后则显示绿色注册成功信息。

综合以上知识，我们来构建一个完整的登录界面：

import javax.swing.*;
import java.awt.*;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;

public class LoginFrame extends JFrame {
private JTextField usernameField;
private JPasswordField passwordField;
private JLabel messageLabel;

public LoginFrame() {
// 设置窗口属性
setTitle("用户登录");
setSize(350, 220);
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
setLocationRelativeTo(null);
setResizable(false);

// 创建主面板
JPanel mainPanel = new JPanel(new GridBagLayout());
GridBagConstraints gbc = new GridBagConstraints();
gbc.insets = new Insets(5, 5, 5, 5);

// 用户名行
gbc.gridx = 0;
gbc.gridy = 0;
mainPanel.add(new JLabel("用户名："), gbc);

gbc.gridx = 1;
usernameField = new JTextField(15);
mainPanel.add(usernameField, gbc);

// 密码行
gbc.gridx = 0;
gbc.gridy = 1;
mainPanel.add(new JLabel("密码："), gbc);

gbc.gridx = 1;
passwordField = new JPasswordField(15);
mainPanel.add(passwordField, gbc);

// 按钮行
gbc.gridx = 0;
gbc.gridy = 2;
gbc.gridwidth = 2;
JPanel buttonPanel = new JPanel(new FlowLayout());
JButton loginButton = new JButton("登录");
JButton resetButton = new JButton("重置");
buttonPanel.add(loginButton);
buttonPanel.add(resetButton);
mainPanel.add(buttonPanel, gbc);

// 提示信息
gbc.gridy = 3;
messageLabel = new JLabel(" ");
messageLabel.setForeground(Color.RED);
mainPanel.add(messageLabel, gbc);

// 添加事件监听
loginButton.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
handleLogin();
}
});

resetButton.addActionListener(new ActionListener() {
@Override
public void actionPerformed(ActionEvent e) {
usernameField.setText("");
passwordField.setText("");
messageLabel.setText(" ");
}
});

add(mainPanel);
}

private void handleLogin() {
String username = usernameField.getText();
String password = new String(passwordField.getPassword());

// 简单验证（实际项目中应连接数据库验证）
if ("admin".equals(username) && "123456".equals(password)) {
messageLabel.setForeground(new Color(0, 128, 0));
messageLabel.setText("登录成功！欢迎 " + username);
} else {
messageLabel.setForeground(Color.RED);
messageLabel.setText("用户名或密码错误！");
}
}

public static void main(String[] args) {
SwingUtilities.invokeLater(new Runnable() {
@Override
public void run() {
new LoginFrame().setVisible(true);
}
});
}
}

6. JavaFX 入门

6.1 JavaFX 简介

JavaFX 是 Java 平台上的下一代 GUI 工具包，它提供了更现代化的 UI 组件、CSS 样式支持和硬件加速渲染能力。从 JDK 11 开始，JavaFX 从 JDK 中分离出来，需要单独引入依赖。

6.1.1 通过 Maven 引入 JavaFX 依赖

在 pom.xml 中添加 JavaFX 依赖。以 JavaFX 21 为例，需要引入 javafx-controls 模块，并根据操作系统引入对应的平台依赖：

<dependencies>
<!– JavaFX 核心控件模块 –>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>21.0.2</version>
</dependency>

<!– 根据操作系统引入对应平台依赖（Windows） –>
<dependency>
<groupId>org.openjfx</groupId>
<artifactId>javafx-controls</artifactId>
<version>21.0.2</version>
<classifier>win</classifier>
</dependency>
</dependencies>

提示：classifier 根据操作系统选择，Windows 为 win，macOS 为 mac，Linux 为 linux。如果使用 JavaFX 的 FXML 功能，还需要额外引入 javafx-fxml 模块。

6.1.2 通过 Gradle 引入 JavaFX 依赖

在 build.gradle 中添加 JavaFX 依赖：

plugins {
id 'application'
id 'org.openjfx.javafxplugin' version '0.1.0'
}

repositories {
mavenCentral()
}

// 配置 JavaFX 版本和所需模块
javafx {
version = '21.0.2'
modules = ['javafx.controls', 'javafx.fxml']
}

// 指定主类
application {
mainClass = 'com.example.HelloJavaFX'
}

6.1.3 在 IntelliJ IDEA 中配置 JavaFX SDK

如果不想使用构建工具，也可以直接下载 JavaFX SDK 并在 IDEA 中手动配置：

6.1.4 配置 VM 参数

运行 JavaFX 应用时，需要指定模块路径，否则会报 JavaFX runtime components are missing 错误。在 IDEA 中配置 VM 参数：

–module-path "D:/javafx-sdk-21.0.2/lib" –add-modules javafx.controls,javafx.fxml

配置完成后，就可以顺利运行后续的 JavaFX 示例代码了。

6.2 第一个 JavaFX 应用

import javafx.application.Application;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

public class HelloJavaFX extends Application {

@Override
public void start(Stage primaryStage) {
// 创建标签和按钮
Label label = new Label("欢迎使用 JavaFX");
Button button = new Button("点击我");

// 为按钮添加事件处理
button.setOnAction(e -> label.setText("你点击了按钮！"));

// 创建垂直布局容器
VBox root = new VBox(10, label, button);
root.setStyle("-fx-padding: 20; -fx-alignment: center;");

// 创建场景并设置到舞台
Scene scene = new Scene(root, 300, 200);
primaryStage.setTitle("JavaFX 入门示例");
primaryStage.setScene(scene);
primaryStage.show();
}

public static void main(String[] args) {
launch(args);
}
}

6.3 使用 FXML 分离界面与逻辑

6.4 JavaFX 实战：登录界面

综合以上知识，我们用 FXML 构建一个完整的 JavaFX 登录界面，实现与第 5 节 Swing 登录界面相同的功能（用户名密码验证、成功/失败提示）。项目结构如下：

src/
└── com/example/
├── LoginApp.java // 启动类
├── LoginController.java // 控制器类
└── login.fxml // 界面布局文件

首先是 FXML 界面文件 login.fxml，负责描述界面结构：

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>

<!– 根容器：垂直排列，居中显示，间距 10 –>
<VBox spacing="10" alignment="CENTER" xmlns:fx="http://javafx.com/fxml"
fx:controller="com.example.LoginController"
style="-fx-padding: 30; -fx-background-color: #f5f5f5;">

<!– 标题标签 –>
<Label text="用户登录" style="-fx-font-size: 22px; -fx-font-weight: bold;"/>

<!– 用户名输入框 –>
<TextField fx:id="usernameField" promptText="请输入用户名" maxWidth="220"/>

<!– 密码输入框 –>
<PasswordField fx:id="passwordField" promptText="请输入密码" maxWidth="220"/>

<!– 按钮行：水平排列 –>
<HBox spacing="10" alignment="CENTER">
<Button text="登录" onAction="#handleLogin" prefWidth="80"/>
<Button text="重置" onAction="#handleReset" prefWidth="80"/>
</HBox>

<!– 提示信息标签（默认隐藏，登录后显示结果） –>
<Label fx:id="messageLabel" text="" style="-fx-font-size: 14px;" visible="false"/>
</VBox>

然后是控制器类 LoginController.java，负责处理登录逻辑：

package com.example;

import javafx.fxml.FXML;
import javafx.scene.control.Label;
import javafx.scene.control.PasswordField;
import javafx.scene.control.TextField;

public class LoginController {

// 通过 @FXML 注解注入 FXML 中声明的组件
@FXML
private TextField usernameField;

@FXML
private PasswordField passwordField;

@FXML
private Label messageLabel;

/**
* 登录按钮的点击事件处理方法
* 方法名与 FXML 中 onAction="#handleLogin" 对应
*/
@FXML
private void handleLogin() {
// 获取用户输入的用户名和密码
String username = usernameField.getText();
String password = passwordField.getText();

// 简单验证（实际项目中应连接数据库验证）
if ("admin".equals(username) && "123456".equals(password)) {
// 登录成功：显示绿色提示
messageLabel.setText("登录成功！欢迎 " + username);
messageLabel.setStyle("-fx-text-fill: green;");
} else {
// 登录失败：显示红色提示
messageLabel.setText("用户名或密码错误！");
messageLabel.setStyle("-fx-text-fill: red;");
}

// 显示提示信息标签
messageLabel.setVisible(true);
}

/**
* 重置按钮的点击事件处理方法
* 清空输入框和提示信息
*/
@FXML
private void handleReset() {
usernameField.clear();
passwordField.clear();
messageLabel.setText("");
messageLabel.setVisible(false);
}
}

最后是启动类 LoginApp.java，负责加载 FXML 并启动应用：

package com.example;

import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;

/**
* JavaFX 登录界面启动类
* 负责加载 FXML 布局文件并启动应用
*/
public class LoginApp extends Application {

@Override
public void start(Stage primaryStage) throws Exception {
// 加载 FXML 布局文件（login.fxml 与 LoginApp.java 位于同一包下）
FXMLLoader loader = new FXMLLoader(getClass().getResource("login.fxml"));
Parent root = loader.load();

// 创建场景并设置到舞台
Scene scene = new Scene(root, 360, 260);
primaryStage.setTitle("JavaFX 登录界面");
primaryStage.setScene(scene);
// 禁止调整窗口大小，保持界面整洁
primaryStage.setResizable(false);
// 显示窗口
primaryStage.show();
}

public static void main(String[] args) {
// 启动 JavaFX 应用
launch(args);
}
}

运行说明

效果描述

运行 LoginApp 后，会弹出一个标题为「JavaFX 登录界面」的窗口，界面包含标题、用户名输入框、密码输入框以及「登录」「重置」两个按钮：

• 登录成功：输入用户名 admin、密码 123456，点击「登录」按钮，窗口底部会显示绿色的「登录成功！欢迎 admin」提示。
• 登录失败：输入错误的用户名或密码，点击「登录」按钮，窗口底部会显示红色的「用户名或密码错误！」提示。
• 重置：点击「重置」按钮，用户名和密码输入框会被清空，提示信息也会被隐藏。

整个界面采用 FXML 声明式布局，配合 CSS 内联样式，视觉上比 Swing 版本更现代、更美观。

JavaFX 支持使用 FXML 文件描述界面结构，实现界面与业务逻辑的分离：

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>

<VBox spacing="10" alignment="CENTER" xmlns:fx="http://javafx.com/fxml"
fx:controller="com.example.LoginController">
<Label text="用户登录" style="-fx-font-size: 20px; -fx-font-weight: bold;"/>
<TextField fx:id="usernameField" promptText="请输入用户名"/>
<PasswordField fx:id="passwordField" promptText="请输入密码"/>
<Button text="登录" onAction="#handleLogin"/>
</VBox>

对应的控制器类：

import javafx.fxml.FXML;
import javafx.scene.control.PasswordField;
import javafx.scene.control.TextField;

public class LoginController {
@FXML
private TextField usernameField;

@FXML
private PasswordField passwordField;

@FXML
private void handleLogin() {
String username = usernameField.getText();
String password = passwordField.getText();
System.out.println("登录尝试：" + username + " / " + password);
}
}

7. Swing 与 JavaFX 对比总结

下面从学习曲线、组件丰富度、CSS 支持、FXML 分离、性能表现、社区活跃度、适用场景等维度，对 Swing 与 JavaFX 进行详细对比：

7.1 如何根据项目需求选择

通过上面的对比可以看出，Swing 与 JavaFX 各有优势，选择哪个框架主要取决于你的项目需求：

• 如果你是初学者，建议从 Swing 入手。它的 API 简单直观，学习曲线平缓，能帮助你快速理解 GUI 编程的核心概念（事件模型、布局管理等），为后续学习打下坚实基础。
• 如果你在维护老项目，且项目基于 Swing 构建，那么继续使用 Swing 是合理的选择。Swing 成熟稳定，社区资料丰富，遇到问题容易找到解决方案。
• 如果你在开发新项目，尤其是需要现代化 UI、复杂动画或富客户端交互的应用，建议优先选择 JavaFX。它支持 CSS 样式、FXML 界面分离和硬件加速，能显著提升开发效率和用户体验。
• 如果你需要快速交付一个简单工具，Swing 的轻量级特性可以让你用更少的代码快速实现功能，适合内部工具或原型验证。

总之，技术选型没有绝对的优劣，关键在于匹配项目需求。建议先明确项目的目标用户、界面复杂度、维护周期和团队技术储备，再结合上表做出合理决策。无论选择哪个框架，扎实掌握 GUI 编程的核心思想（事件驱动、布局管理、线程模型）才是最重要的。

8. 常见问题与调试技巧

8.1 界面不显示

• 检查是否调用了 setVisible(true)
• 确认 main 方法中是否正确创建了窗口对象
• 查看控制台是否有异常堆栈输出

8.2 中文乱码

• 确保源文件编码为 UTF-8
• 在 IDE 中设置项目编码为 UTF-8
• 编译时指定 -encoding UTF-8 参数

8.3 事件不响应

• 确认是否正确添加了监听器
• 检查组件是否被其他组件遮挡
• 确认事件处理方法签名是否正确

8.4 线程问题

Swing 和 JavaFX 都是单线程模型，所有 UI 操作必须在事件分发线程（EDT）中执行。耗时操作应放在后台线程，然后通过 SwingUtilities.invokeLater 或 Platform.runLater 更新界面。

Swing 与 JavaFX 线程模型对比

核心原则：无论使用哪个框架，都禁止在后台线程中直接操作 UI 组件，否则会引发界面卡顿、渲染异常甚至程序崩溃。正确做法是：耗时任务在后台线程执行，任务完成后通过回调机制切回 UI 线程更新界面。

Swing 示例：使用 SwingWorker 执行后台任务

import javax.swing.*;
import java.awt.*;
import java.util.List;

public class SwingWorkerDemo extends JFrame {
private JLabel statusLabel;
private JButton startButton;
private JProgressBar progressBar;

public SwingWorkerDemo() {
setTitle("SwingWorker 示例");
setSize(350, 150);
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
setLocationRelativeTo(null);
setLayout(new FlowLayout());

statusLabel = new JLabel("等待开始");
startButton = new JButton("开始任务");
progressBar = new JProgressBar(0, 100);
progressBar.setPreferredSize(new Dimension(300, 20));

startButton.addActionListener(e -> startTask());

add(statusLabel);
add(progressBar);
add(startButton);
}

private void startTask() {
// 禁用按钮，防止重复点击
startButton.setEnabled(false);
statusLabel.setText("任务执行中…");

// 创建 SwingWorker：后台执行耗时任务，并在 EDT 中更新 UI
SwingWorker<Void, Integer> worker = new SwingWorker<Void, Integer>() {
@Override
protected Void doInBackground() throws Exception {
// 在后台线程中执行耗时操作（如网络请求、文件读取）
for (int i = 0; i <= 100; i += 10) {
Thread.sleep(200); // 模拟耗时操作
publish(i); // 将中间进度发布到 process()
}
return null;
}

@Override
protected void process(List<Integer> chunks) {
// 在 EDT 中执行，安全更新 UI
int latest = chunks.get(chunks.size() – 1);
progressBar.setValue(latest);
statusLabel.setText("进度：" + latest + "%");
}

@Override
protected void done() {
// 任务完成后在 EDT 中执行
statusLabel.setText("任务完成！");
startButton.setEnabled(true);
}
};

worker.execute(); // 启动后台任务
}

public static void main(String[] args) {
SwingUtilities.invokeLater(() -> new SwingWorkerDemo().setVisible(true));
}
}

JavaFX 示例：使用 Platform.runLater 更新界面

import javafx.application.Application;
import javafx.application.Platform;
import javafx.concurrent.Task;
import javafx.geometry.Pos;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.Label;
import javafx.scene.control.ProgressBar;
import javafx.scene.layout.VBox;
import javafx.stage.Stage;

public class PlatformRunLaterDemo extends Application {

@Override
public void start(Stage primaryStage) {
Label statusLabel = new Label("等待开始");
Button startButton = new Button("开始任务");
ProgressBar progressBar = new ProgressBar(0);
progressBar.setPrefWidth(300);

startButton.setOnAction(e -> {
// 禁用按钮，防止重复点击
startButton.setDisable(true);
statusLabel.setText("任务执行中…");

// 创建后台任务
Task<Void> task = new Task<Void>() {
@Override
protected Void call() throws Exception {
// 在后台线程中执行耗时操作
for (int i = 0; i <= 100; i += 10) {
Thread.sleep(200); // 模拟耗时操作
int progress = i;

// 通过 Platform.runLater 切回 FX 线程更新 UI
Platform.runLater(() -> {
progressBar.setProgress(progress / 100.0);
statusLabel.setText("进度：" + progress + "%");
});
}
return null;
}
};

// 任务完成后的回调（在 FX 线程中执行）
task.setOnSucceeded(event -> {
statusLabel.setText("任务完成！");
startButton.setDisable(false);
});

// 启动后台线程
Thread thread = new Thread(task);
thread.setDaemon(true);
thread.start();
});

VBox root = new VBox(15, statusLabel, progressBar, startButton);
root.setAlignment(Pos.CENTER);
root.setStyle("-fx-padding: 30;");

Scene scene = new Scene(root, 380, 180);
primaryStage.setTitle("Platform.runLater 示例");
primaryStage.setScene(scene);
primaryStage.show();
}

public static void main(String[] args) {
launch(args);
}
}

提示：JavaFX 更推荐使用 Task 配合 updateProgress() 方法，它会自动在 FX 线程中更新进度属性，无需手动调用 Platform.runLater。上面的示例是为了直观展示 Platform.runLater 的用法，实际项目中可优先使用 Task 的内置回调机制。

Swing 和 JavaFX 都是单线程模型，所有 UI 操作必须在事件分发线程（EDT）中执行。耗时操作应放在后台线程，然后通过 SwingUtilities.invokeLater 或 Platform.runLater 更新界面。

9. 进阶学习方向

掌握了基础之后，你可以从以下几个方向继续深入：

10. 总结

本教程从 Java GUI 开发的基础概念出发，系统介绍了 Swing 和 JavaFX 两大主流框架。通过 Swing 的学习，你掌握了窗口创建、组件使用、事件处理和布局管理等核心技能；通过 JavaFX 的入门，你了解了现代化 GUI 开发的思路和 FXML 分离模式。

GUI 开发是一个实践性很强的领域，建议你动手编写每一个示例代码，并尝试在此基础上进行扩展和改造。遇到问题时，善用 IDE 的调试功能和搜索引擎，逐步培养独立解决问题的能力。

希望本教程能为你的 Java GUI 开发之路打下坚实的基础。祝你编码愉快！