简介这份资源面向Java初学者与需要巩固GUI编程的开发者聚焦窗体设计与图形界面开发帮助解决从组件使用到事件响应的实践问题。包内共187个文件以42个java源码、49个class字节码和43个rar子包为主另含jcw、jcp工程文件、htm/html说明页及少量图片与音频素材压缩包约643KB便于按示例逐个运行调试。内容覆盖Swing与JavaFX两大方向涉及JFrame窗口创建、JButton与JLabel等组件、FlowLayout与BorderLayout等布局管理器以及ActionListener事件处理并延伸至FXML界面分离与CSS样式美化。已有1560人学习下载适合对照代码理解窗口生命周期与界面组织方式也可作为课程设计或小型桌面应用的参考素材帮助读者快速上手并提升窗体设计技能。1. Java 窗体设计到底在做什么从一次“按钮点了没反应”说起很多人第一次写 Java 窗体设计代码能编译、窗口能弹出来但点按钮没反应、关窗口进程不退出、中文变成方块。这不是玄学是 GUI 编程里事件分发线程和布局管理器在“教做人”。Java 窗体设计指的是用 Swing 或 JavaFX 构建桌面图形界面窗口、按钮、文本框、表格、菜单以及它们背后的布局、事件、绘制和线程模型。它适合需要做内部工具、教学演示、数据录入端、串口调试面板的开发者——不想碰前端框架又需要一个能双击运行的本地界面。GUI 经典代码全放送的价值不在“代码多”而在于把事件绑定、布局嵌套、线程刷新这三件事用可复现的最小例子讲透。下面按“能跑起来 → 能改参数 → 能排错 → 能进阶”的顺序展开代码全部基于 Swing因为存量项目最多、资料最杂、坑也最集中。2. 用 Swing 搭出第一个可交互窗体最小可运行骨架与事件绑定2.1 为什么先选 Swing 而不是 JavaFX选型理由很实际Swing 是 JDK 自带不需要额外依赖javac和java两条命令就能跑存量企业工具、教学实验、老系统维护几乎都是 Swing。JavaFX 从 JDK 11 起被移出标准库要单独引入模块对新手和离线环境不友好。常见做法是新项目如果允许联网拉依赖可以用 JavaFX 做更现代的界面但如果是维护、教学、快速验证Swing 的“零配置”优势无可替代。下面所有代码都在 JDK 8 及以上验证通过不需要 Maven。2.2 最小可运行窗体一个按钮加一个标签import javax.swing.*; import java.awt.*; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; public class FirstFrame { public static void main(String[] args) { // 所有 Swing 组件创建和更新都应在事件分发线程中执行 SwingUtilities.invokeLater(() - { JFrame frame new JFrame(最小窗体示例); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setSize(400, 200); // 使用 BorderLayout中间放标签底部放按钮 frame.setLayout(new BorderLayout()); JLabel label new JLabel(等待点击, SwingConstants.CENTER); label.setFont(new Font(微软雅黑, Font.PLAIN, 16)); frame.add(label, BorderLayout.CENTER); JButton button new JButton(点我); button.addActionListener(new ActionListener() { Override public void actionPerformed(ActionEvent e) { label.setText(按钮被点击了); } }); frame.add(button, BorderLayout.SOUTH); // 居中显示避免窗口出现在屏幕左上角 frame.setLocationRelativeTo(null); frame.setVisible(true); }); } }逻辑说明SwingUtilities.invokeLater把整个界面构建放到事件分发线程EDT这是 Swing 线程模型的第一条铁律。setDefaultCloseOperation(EXIT_ON_CLOSE)决定点关闭按钮时是否结束进程不设的话窗口关了进程还在。BorderLayout把标签放中间、按钮放底部是最省事的布局。参数说明setSize(400, 200)是窗口初始宽高单位像素setLocationRelativeTo(null)让窗口屏幕居中字体设置里“微软雅黑”在部分 Linux 环境不存在会回退到默认字体中文可能变方块后面避坑章节会讲。2.3 事件绑定的三种写法与选择上面用的是匿名内部类最直观但代码冗长。第二种是 Lambda 表达式JDK 8 以上可用button.addActionListener(e - label.setText(Lambda 点击));第三种是让当前类实现ActionListener接口适合多个按钮共用逻辑public class MyFrame extends JFrame implements ActionListener { private JLabel label; public MyFrame() { label new JLabel(等待, SwingConstants.CENTER); JButton b1 new JButton(按钮A); JButton b2 new JButton(按钮B); b1.setActionCommand(A); b2.setActionCommand(B); b1.addActionListener(this); b2.addActionListener(this); } Override public void actionPerformed(ActionEvent e) { // 通过 actionCommand 区分是哪个按钮触发 label.setText(触发了 e.getActionCommand()); } }选择建议单个按钮用 Lambda多个按钮逻辑相似、需要复用方法时用实现接口加setActionCommand需要访问外部局部变量且逻辑复杂时用匿名内部类。注意 Lambda 捕获的局部变量必须是 final 或事实 final这是编译期就会报的错不是运行期玄学。2.4 布局管理器为什么你的按钮“挤成一团”Swing 默认给JFrame的内容面板用的是BorderLayout直接add多个组件会互相覆盖。常见做法是嵌套面板外层用BorderLayout分区域每个区域里放一个JPanelJPanel再用FlowLayout或GridLayout排子组件。JPanel topPanel new JPanel(new FlowLayout(FlowLayout.LEFT)); topPanel.add(new JLabel(用户名)); topPanel.add(new JTextField(12)); JPanel centerPanel new JPanel(new GridLayout(2, 2, 8, 8)); centerPanel.add(new JLabel(密码)); centerPanel.add(new JPasswordField(12)); centerPanel.add(new JLabel(端口)); centerPanel.add(new JTextField(6)); frame.add(topPanel, BorderLayout.NORTH); frame.add(centerPanel, BorderLayout.CENTER);参数说明FlowLayout.LEFT让组件从左往右排窗口变窄时自动换行GridLayout(2, 2, 8, 8)表示 2 行 2 列水平垂直间距各 8 像素。JTextField(12)里的 12 是列数影响首选宽度不是字符数硬限制。布局嵌套是 Swing 窗体设计的核心技能不要试图用一个布局管理器解决所有问题。3. 把窗体从“能看”做到“能用”表格、对话框与数据回填3.1 JTable 最小可用模型别直接往表格里塞数据JTable不存数据它只负责显示数据在TableModel里。新手最容易犯的错是直接new JTable(Object[][], Object[])然后发现增删行不会刷新。正确做法是继承AbstractTableModelimport javax.swing.table.AbstractTableModel; import java.util.ArrayList; import java.util.List; public class UserTableModel extends AbstractTableModel { private final String[] columns {姓名, 部门, 工号}; private final ListObject[] rows new ArrayList(); public void addRow(String name, String dept, String id) { rows.add(new Object[]{name, dept, id}); // 通知表格有新行插入否则界面不刷新 fireTableRowsInserted(rows.size() - 1, rows.size() - 1); } public void removeRow(int rowIndex) { rows.remove(rowIndex); fireTableRowsDeleted(rowIndex, rowIndex); } Override public int getRowCount() { return rows.size(); } Override public int getColumnCount() { return columns.length; } Override public String getColumnName(int column) { return columns[column]; } Override public Object getValueAt(int rowIndex, int columnIndex) { return rows.get(rowIndex)[columnIndex]; } }逻辑说明fireTableRowsInserted和fireTableRowsDeleted是模型通知视图刷新的标准方式不调用的话数据变了界面不动。参数说明getColumnName返回表头文字getValueAt返回单元格显示值返回null会显示空白。把模型挂到表格上UserTableModel model new UserTableModel(); JTable table new JTable(model); JScrollPane scrollPane new JScrollPane(table); frame.add(scrollPane, BorderLayout.CENTER); model.addRow(张三, 研发, E001);注意JTable必须放进JScrollPane否则表头和滚动条都不会出现。3.2 模态对话框取值JOptionPane 与自定义对话框简单输入用JOptionPaneString name JOptionPane.showInputDialog(frame, 请输入姓名); if (name ! null !name.trim().isEmpty()) { model.addRow(name, 未分配, TMP); }showInputDialog返回null表示用户点了取消或关闭必须判空否则后面trim()会抛空指针。复杂表单用自定义JDialogJDialog dialog new JDialog(frame, 新增用户, true); // true 表示模态 dialog.setLayout(new GridLayout(4, 2, 8, 8)); JTextField nameField new JTextField(); JTextField deptField new JTextField(); JTextField idField new JTextField(); dialog.add(new JLabel(姓名)); dialog.add(nameField); dialog.add(new JLabel(部门)); dialog.add(deptField); dialog.add(new JLabel(工号)); dialog.add(idField); JButton ok new JButton(确定); ok.addActionListener(e - { model.addRow(nameField.getText(), deptField.getText(), idField.getText()); dialog.dispose(); // 关闭对话框释放资源 }); dialog.add(ok); dialog.pack(); // 按首选大小自动调整 dialog.setLocationRelativeTo(frame); dialog.setVisible(true);参数说明JDialog(frame, 标题, true)第三个参数true是模态阻塞父窗口操作pack()根据组件首选大小自动计算窗口尺寸比手动setSize更稳dispose()只销毁对话框不影响主窗口。3.3 数据回填与表格选中行联动点击表格某行把数据填回上方输入框是数据录入端的常见需求table.getSelectionModel().addListSelectionListener(e - { if (!e.getValueIsAdjusting()) { // 避免选中过程中触发多次 int row table.getSelectedRow(); if (row 0) { nameField.setText((String) table.getValueAt(row, 0)); deptField.setText((String) table.getValueAt(row, 1)); idField.setText((String) table.getValueAt(row, 2)); } } });getValueIsAdjusting()返回true表示用户还在拖动选择此时不处理可以避免重复刷新。getSelectedRow()返回 -1 表示没有选中行必须判断。getValueAt返回Object要强制转型列顺序和模型里columns数组一致。4. 避坑与排查Swing 窗体设计里最容易翻车的 5 个点4.1 界面卡死在 EDT 里做耗时操作现象点按钮后窗口拖动不了、按钮变灰任务管理器显示进程无响应。原因actionPerformed运行在事件分发线程里面做数据库查询、文件读写、网络请求都会阻塞界面刷新。解决耗时逻辑放到SwingWorker的doInBackground结果回传用donenew SwingWorkerString, Void() { Override protected String doInBackground() throws Exception { Thread.sleep(3000); // 模拟耗时任务 return 加载完成; } Override protected void done() { try { label.setText(get()); // get() 取回 doInBackground 的返回值 } catch (Exception ex) { label.setText(出错 ex.getMessage()); } } }.execute();注意done()里调用get()会抛异常必须捕获publish/process用于中途更新进度不是必须。4.2 中文变方块字体与编码双重问题现象界面上中文显示为方框或问号。原因一运行环境缺少对应字体new Font(宋体, ...)找不到就回退到逻辑字体。原因二源码文件编码和编译编码不一致javac默认用平台编码。解决源码统一用 UTF-8 保存编译时加-encoding UTF-8字体设置用Font.SANS_SERIF逻辑字体名让系统自动映射javac -encoding UTF-8 FirstFrame.java java FirstFrame如果仍然方块检查系统是否安装了中文字体包这是环境问题不是代码问题。4.3 窗口关了进程不退出现象点右上角关闭窗口消失但java进程还在。原因setDefaultCloseOperation默认是HIDE_ON_CLOSE只是隐藏窗口或者你开了非守护线程如定时器没停。解决主窗口设EXIT_ON_CLOSE如果有Timer在窗口关闭事件里调用timer.stop()frame.addWindowListener(new java.awt.event.WindowAdapter() { Override public void windowClosing(java.awt.event.WindowEvent e) { timer.stop(); frame.dispose(); System.exit(0); } });4.4 组件不刷新忘了 revalidate 和 repaint现象动态往面板里加按钮界面没变化。原因Swing 组件添加后需要重新布局和重绘。解决添加或移除组件后调用panel.revalidate()再panel.repaint()。revalidate()通知布局管理器重新计算位置repaint()请求重绘。只调repaint()不够因为布局没更新。4.5 空指针与类型转换异常现象点按钮抛NullPointerException或ClassCastException。原因JOptionPane.showInputDialog返回null没判空table.getValueAt返回Object直接当String用但某列实际存的是Integer。解决所有对话框返回值先判空表格取值用String.valueOf(table.getValueAt(row, col))兜底或者模型里统一存String。血泪经验表格列类型不统一是后期最难查的 bug 之一建模时就该定好每列类型。5. 进阶技巧用自定义绘制和快捷键把工具感做出来5.1 自定义 JPanel 绘制状态指示灯与简易图表Swing 允许重写paintComponent做自定义绘制适合做状态灯、进度环、简易折线图。关键原则先调super.paintComponent(g)清空背景否则残影所有绘制基于组件当前尺寸不要写死坐标。JPanel indicator new JPanel() { private boolean active false; public void setActive(boolean active) { this.active active; repaint(); // 状态变了主动请求重绘 } Override protected void paintComponent(Graphics g) { super.paintComponent(g); Graphics2D g2 (Graphics2D) g; // 开启抗锯齿圆形边缘更平滑 g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2.setColor(active ? new Color(46, 204, 113) : new Color(189, 195, 199)); int d Math.min(getWidth(), getHeight()) - 10; g2.fillOval(5, 5, d, d); } }; indicator.setPreferredSize(new Dimension(40, 40));参数说明RenderingHints.KEY_ANTIALIASING开抗锯齿圆形不毛边getWidth()/getHeight()是运行时尺寸窗口缩放时绘制自动适配setPreferredSize告诉布局管理器这个组件想要多大。把indicator放进面板按钮点击时调setActive(true)就能看到状态变化。5.2 快捷键与输入校验让工具“顺手”给按钮绑快捷键用InputMap和ActionMap比KeyListener可靠因为KeyListener依赖焦点焦点在别的组件上就失效JButton saveBtn new JButton(保存); saveBtn.addActionListener(e - saveData()); InputMap im saveBtn.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW); im.put(KeyStroke.getKeyStroke(ctrl S), save); ActionMap am saveBtn.getActionMap(); am.put(save, new AbstractAction() { Override public void actionPerformed(ActionEvent e) { saveData(); } });WHEN_IN_FOCUSED_WINDOW表示只要窗口有焦点就生效不要求按钮本身有焦点。输入校验用InputVerifier或DocumentFilter前者在焦点离开时校验后者在输入过程中过滤JTextField portField new JTextField(6); portField.setInputVerifier(new InputVerifier() { Override public boolean verify(JComponent input) { String text ((JTextField) input).getText(); try { int port Integer.parseInt(text); return port 0 port 65536; } catch (NumberFormatException e) { return false; } } });verify返回false时焦点不会离开该输入框用户必须改对才能点别的。注意这会影响“取消”按钮的点击如果表单有取消操作取消按钮要设setVerifyInputWhenFocusTarget(false)。5.3 打包与分发让非开发者也能双击运行代码写完后用jar打包成可执行文件javac -encoding UTF-8 -d out src/*.java jar cfe app.jar FirstFrame -C out . java -jar app.jarcfe三个参数分别是创建 jar、指定入口类、指定 jar 文件名。-C out .表示切换到 out 目录把编译产物打进去。如果项目有图片、配置文件放在src同级目录打包时一起加进去代码里用getClass().getResource(/config.properties)读取不要用绝对路径。分发时对方只需要一个app.jar和 JRE不需要 JDK。我自己的习惯是每写完一个窗体先跑一遍“关窗口看进程退不退、点按钮看界面卡不卡、切输入法看中文正不正常”这三步再往下写业务逻辑。GUI 的坑大多不在算法而在这些边角。希望帮到你。本文还有配套的精品资源点击获取