简介这份资源面向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 窗体 GUI 代码到底能救什么急上周帮一个做内部工具的朋友看代码他那个用 Java 写的桌面客户端主界面是拿绝对坐标一格一格摆出来的。窗口一拉大按钮全挤在左上角表格和输入框叠在一起调了三个小时没调明白。这种场景我见得太多了——很多人学 Java 窗体设计第一反应就是setBounds()硬编码结果分辨率一变、字体一换整个界面就翻车。这套「Java 窗体设计 GUI 经典代码全放送」的资源核心价值就在这儿它不是讲抽象理论而是把 Swing 和 AWT 里那些真正能跑、能改、能复用的窗体代码整理出来覆盖布局管理器、事件监听、表格模型、对话框、菜单栏这些高频模块。适合谁一是刚学完 Java 基础、要交课程设计但不知道界面怎么下手的学生二是工作里偶尔要写个内部小工具、不想在 UI 上耗太久的后端开发。你不需要从零啃完整个 Swing 文档照着这些代码块改参数、换组件就能把窗体跑起来。2. 窗体骨架与布局管理器为什么你的界面一拉就散2.1 先搞懂 JFrame 的生命周期和线程模型很多新手写窗体直接在main方法里new JFrame()然后setVisible(true)跑起来看着没问题但一旦在按钮点击里更新界面就偶尔卡死或者界面不刷新。根因是 Swing 不是线程安全的所有对组件的修改都应该在事件调度线程EDT里做。常见做法是用SwingUtilities.invokeLater()把创建窗体的代码包起来。import javax.swing.*; public class MainFrame extends JFrame { public MainFrame() { // 设置窗体标题 setTitle(内部工具主界面); // 设置关闭行为关闭窗口时退出程序 setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); // 设置初始大小宽 900 高 600 setSize(900, 600); // 相对屏幕居中避免每次手动算坐标 setLocationRelativeTo(null); // 这里先不添加组件留给后面的布局 } public static void main(String[] args) { // 关键把窗体创建放到 EDT 里避免线程冲突 SwingUtilities.invokeLater(() - { MainFrame frame new MainFrame(); frame.setVisible(true); }); } }这段代码里setDefaultCloseOperation有三个常用值EXIT_ON_CLOSE直接退出进程DISPOSE_ON_CLOSE只销毁当前窗口HIDE_ON_CLOSE只是隐藏。如果你做多窗口切换用DISPOSE_ON_CLOSE更合适否则关掉子窗口会把整个程序干掉。setLocationRelativeTo(null)是让窗口居中传null表示相对屏幕居中传某个组件则相对该组件居中。参数上setSize只是初始大小用户还能拖真正限制最小尺寸要用setMinimumSize(new Dimension(800, 500))。2.2 布局管理器选型BorderLayout 和 GridBagLayout 怎么选绝对定位之所以翻车是因为它不响应窗口变化。Swing 提供了多种布局管理器我一般按这个思路选整体框架用BorderLayout把窗口分成 NORTH、SOUTH、WEST、EAST、CENTER 五个区域表单区域用GridBagLayout因为它能控制权重和填充按钮组用FlowLayout或GridLayout。import javax.swing.*; import java.awt.*; public class LayoutDemo extends JFrame { public LayoutDemo() { setTitle(布局管理器示例); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setSize(800, 500); setLocationRelativeTo(null); // 窗体默认就是 BorderLayout这里显式设置便于阅读 setLayout(new BorderLayout(10, 10)); // 顶部放工具栏 JToolBar toolBar new JToolBar(); toolBar.add(new JButton(新建)); toolBar.add(new JButton(保存)); add(toolBar, BorderLayout.NORTH); // 中间放一个带滚动条的文本区 JTextArea textArea new JTextArea(); // 自动换行避免横向滚动 textArea.setLineWrap(true); textArea.setWrapStyleWord(true); add(new JScrollPane(textArea), BorderLayout.CENTER); // 底部放状态栏 JLabel statusLabel new JLabel(就绪); add(statusLabel, BorderLayout.SOUTH); } public static void main(String[] args) { SwingUtilities.invokeLater(() - new LayoutDemo().setVisible(true)); } }BorderLayout的构造参数(10, 10)表示水平和垂直间距。注意同一个区域只能放一个组件放第二个会覆盖第一个。如果你需要在一个区域里放多个组件得先套一个JPanel。JScrollPane是必须的否则文本区内容多了不会出现滚动条用户就看不到下面的内容。GridBagLayout的坑更多GridBagConstraints里的weightx和weighty默认是 0意味着窗口拉大时该组件不跟着变必须显式设置权重否则又会出现“拉大窗口组件不动”的玄学现象。2.3 事件监听ActionListener 和 Lambda 的配合事件处理是窗体设计的另一个高频翻车点。很多人给按钮加了ActionListener但里面直接操作数据库或者做耗时计算结果界面卡死。正确做法是耗时操作放到SwingWorker里ActionListener只负责触发。JButton queryBtn new JButton(查询); queryBtn.addActionListener(e - { // 禁用按钮防止重复点击 queryBtn.setEnabled(false); // 用 SwingWorker 在后台执行耗时任务 new SwingWorkerString, Void() { Override protected String doInBackground() throws Exception { // 模拟耗时查询实际替换成你的业务逻辑 Thread.sleep(2000); return 查询完成共 42 条记录; } Override protected void done() { try { // done() 在 EDT 中执行可以安全更新界面 String result get(); statusLabel.setText(result); } catch (Exception ex) { statusLabel.setText(查询失败 ex.getMessage()); } finally { queryBtn.setEnabled(true); } } }.execute(); });doInBackground在后台线程跑不能碰组件done回到 EDT可以安全更新。get()会阻塞直到任务完成但因为在done里调用此时任务已经结束不会卡界面。参数上SwingWorkerString, Void第一个泛型是最终返回类型第二个是中间进度类型如果不需要进度就写Void。3. 表格、对话框与菜单把数据装进窗体的三个实战模块3.1 JTable 与 TableModel别再用二维数组硬塞了JTable是窗体里最容易写乱的部分。新手常直接new JTable(data, headers)数据一变就得重建整个表。更稳的做法是自定义AbstractTableModel把数据源和视图解耦。import javax.swing.table.AbstractTableModel; import java.util.ArrayList; import java.util.List; public class UserTableModel extends AbstractTableModel { // 列名数组顺序决定表格列顺序 private final String[] columns {编号, 姓名, 部门}; // 用 List 存数据每行是一个 Object 数组 private final ListObject[] rows new ArrayList(); public void addRow(Object[] row) { // 先更新数据源再通知表格刷新 rows.add(row); // 通知最后一行插入避免全表重绘 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]; } Override public boolean isCellEditable(int rowIndex, int columnIndex) { // 默认不可编辑需要编辑的列单独返回 true return false; } }fireTableRowsInserted和fireTableRowsDeleted是必须调用的否则数据变了界面不刷新。isCellEditable默认返回false如果你想让某列可编辑就在里面判断columnIndex。表格放进窗体时记得套JScrollPane并且设置setAutoResizeMode(JTable.AUTO_RESIZE_OFF)配合列宽手动控制否则列宽会随窗口变化乱跳。3.2 模态对话框JDialog 和 JOptionPane 的使用边界简单提示用JOptionPane复杂表单用JDialog。JOptionPane的showConfirmDialog返回值是整数对应YES_OPTION、NO_OPTION、CANCEL_OPTION别用 0这种魔法数字去判断。int choice JOptionPane.showConfirmDialog( parentFrame, // 父组件决定对话框居中位置 确认删除选中记录, // 提示消息 删除确认, // 标题 JOptionPane.YES_NO_OPTION, // 按钮组合 JOptionPane.WARNING_MESSAGE // 图标类型 ); if (choice JOptionPane.YES_OPTION) { // 执行删除逻辑 model.removeRow(selectedRow); }JDialog的模态设置用setModal(true)这样对话框弹出时父窗口不能操作。注意JDialog的默认关闭行为是HIDE_ON_CLOSE如果你在对话框里点了确定按钮要手动调用dispose()释放资源否则反复打开会内存泄漏。3.3 菜单栏与快捷键JMenuBar 的层级结构菜单栏的结构是JMenuBar→JMenu→JMenuItem三层嵌套。快捷键用setAccelerator注意它和setMnemonic的区别setMnemonic是 Alt 加字母打开菜单setAccelerator是全局快捷键直接触发。JMenuBar menuBar new JMenuBar(); JMenu fileMenu new JMenu(文件); // AltF 打开文件菜单 fileMenu.setMnemonic(F); JMenuItem newItem new JMenuItem(新建); // CtrlN 直接触发新建 newItem.setAccelerator(KeyStroke.getKeyStroke(ctrl N)); newItem.addActionListener(e - { // 新建逻辑 textArea.setText(); }); fileMenu.add(newItem); JMenuItem exitItem new JMenuItem(退出); exitItem.addActionListener(e - System.exit(0)); fileMenu.addSeparator(); // 分隔线 fileMenu.add(exitItem); menuBar.add(fileMenu); setJMenuBar(menuBar);KeyStroke.getKeyStroke(ctrl N)里的修饰键用小写字母大写。addSeparator()加分隔线别用空菜单项凑数。菜单项的文字里可以用指定助记符但和setMnemonic二选一混用会冲突。4. 避坑与排查窗体代码跑不起来时先看这五条4.1 界面空白或组件不显示现象窗体出来了但里面什么都没有或者只有一部分组件。原因通常是布局管理器没设对或者组件加到了错误的容器上。比如你setLayout(null)之后忘了setBounds组件尺寸就是 0。解决先确认容器的布局管理器用BorderLayout时检查是否把组件加到了 CENTER 以外的区域但没设尺寸。排查时可以在组件创建后打印getPreferredSize()看是不是 0。4.2 点击按钮没反应现象按钮能点但监听器里的代码不执行。原因可能是监听器加错了对象比如加到了JButton的父容器上或者ActionListener里抛了异常被吞掉。解决在监听器第一行加System.out.println(clicked)确认是否进入如果没打印就是监听器没绑上。另外setEnabled(false)之后按钮不响应点击检查是否在别处禁用了。4.3 中文乱码或字体发虚现象界面上的中文显示成方块或者字体模糊。原因通常是系统默认字体不支持中文或者用了setFont但字体名写错。解决显式设置支持中文的字体比如new Font(微软雅黑, Font.PLAIN, 14)但要注意跨平台时字体名可能不存在稳妥做法是用UIManager全局设置。另外高 DPI 屏幕下 Swing 默认缩放可能模糊可以加-Dsun.java2d.uiScale2启动参数。4.4 窗口关闭后进程不退出现象点了关闭按钮窗口消失了但任务管理器里 Java 进程还在。原因是有非守护线程还在跑比如你起了Timer或者SwingWorker没结束。解决setDefaultCloseOperation用EXIT_ON_CLOSE会强制退出但更好的做法是在windowClosing里手动停止所有线程再dispose()。用SwingWorker时在done里检查isCancelled()窗口关闭时调用cancel(true)。4.5 表格数据更新后界面不刷新现象往List里加了数据但JTable还是旧的。原因是没有调用fireTableDataChanged或对应的行插入/删除通知。解决任何修改数据源的操作之后必须调用fire开头的方法。如果你直接操作DefaultTableModel用addRow和removeRow它会自动通知但自定义AbstractTableModel时通知得自己发。排查时可以在getRowCount里打印返回值看模型是否真的更新了。5. 进阶技巧把窗体代码改造成可复用的组件库5.1 用工厂方法统一创建常用组件写多了会发现很多窗体都在重复创建“带标签的输入框”“带滚动条的表格”“确认对话框”。我一般会抽一个UIUtils类把这些封装成静态方法。import javax.swing.*; import java.awt.*; public class UIUtils { // 创建带标签的输入框标签在左输入框在右 public static JPanel createLabeledField(String labelText, JTextField field) { JPanel panel new JPanel(new BorderLayout(5, 0)); JLabel label new JLabel(labelText); // 固定标签宽度避免不同标签长度导致输入框对齐错乱 label.setPreferredSize(new Dimension(80, 25)); panel.add(label, BorderLayout.WEST); panel.add(field, BorderLayout.CENTER); return panel; } // 创建带滚动条的表格统一设置行高和选择模式 public static JScrollPane createTablePane(JTable table) { table.setRowHeight(28); table.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); // 禁止列拖动保持列顺序稳定 table.getTableHeader().setReorderingAllowed(false); return new JScrollPane(table); } }setPreferredSize固定标签宽度是为了让多个输入框左对齐不然标签文字长短不一会导致输入框参差不齐。setReorderingAllowed(false)禁止用户拖动列头内部工具里这个功能基本没用反而容易误操作。5.2 用 CardLayout 做多页面切换内部工具经常需要在“列表页”和“详情页”之间切换。用CardLayout比开多个窗口更清爽。JPanel cardPanel new JPanel(new CardLayout()); cardPanel.add(listPanel, list); cardPanel.add(detailPanel, detail); // 切换时获取布局对象 CardLayout cl (CardLayout) cardPanel.getLayout(); cl.show(cardPanel, detail);CardLayout的show方法第二个参数是添加时的名称必须完全匹配。切换时不会销毁组件所以详情页的数据需要手动刷新可以在show之前调用详情页的刷新方法。5.3 验证方法用简单的断言检查布局改完布局后怎么确认组件真的按预期排列我习惯在main里加一段临时验证代码打印关键组件的边界。SwingUtilities.invokeLater(() - { MainFrame frame new MainFrame(); frame.setVisible(true); // 临时验证打印工具栏和文本区的实际位置和大小 System.out.println(ToolBar bounds: frame.getToolBar().getBounds()); System.out.println(TextArea bounds: frame.getTextArea().getBounds()); });如果打印出来的宽高是 0 或者负数说明布局没生效。这个方法比截图量像素快得多尤其适合在调整GridBagLayout权重时反复验证。5.4 一个我踩过的坑别在构造器里做耗时初始化早期我写窗体喜欢在构造器里直接查数据库填充表格结果new MainFrame()卡好几秒用户以为程序没启动。后来改成构造器只搭骨架数据加载放到windowOpened事件里或者用SwingWorker异步加载。从那以后我每次写窗体都强制走一遍构造器里只做setSize、setLocationRelativeTo、setLayout和组件创建任何 IO 操作都挪到invokeLater之后或者独立线程里。这个习惯帮我省掉了不少“界面假死”的投诉。希望帮到你。本文还有配套的精品资源点击获取