您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Java Swing GUI 開發入門指南：從 AWT 到 Swing 核心組件與佈局實戰

編輯：Java 相關知識

Java 不只是做後端，Swing 能構建原生跨平台桌面應用。本文面向零基礎開發者，系統講解 AWT/Swing 區別、窗口與事件模型、核心組件（按鈕、文本框）、容器與佈局管理，附完整可運行代碼與截圖，帶你入門桌面開發。

一、AWT vs Swing：重量級 vs 輕量級

AWT：調用系統原生組件（重量級），外觀隨平台變化，組件少，混用 Swing 會導致 Z-Order 層級錯亂（AWT 組件永遠在最上層）。
Swing：純 Java 繪製（輕量級），外觀一致（可插拔 LookAndFeel），組件豐富（表格、樹、標籤頁等），主流選擇。
原則：不要混用 AWT 和 Swing 組件，全項目統一用 Swing。

二、窗口、事件與監聽器：事件驅動編程核心

顯示窗口三步驟


JFrame frame = new JFrame("標題");
frame.setSize(400, 300);      // 或 frame.pack() 自適應
frame.setVisible(true);       // 必須調用
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); // 關閉退出 JVM

事件監聽機制

組件提供 addXxxListener 註冊監聽器。
監聽器是接口（如 ActionListener、WindowListener），通常用適配器類（WindowAdapter）只重寫關心的方法。
事件對象（ActionEvent、WindowEvent）攜帶事件源、時間戳等上下文。

窗口關鍵事件


frame.addWindowListener(new WindowAdapter() {
    @Override
    public void windowClosing(WindowEvent e) {
        System.exit(0); // 或 frame.dispose() 僅關閉窗口
    }
    @Override
    public void windowActivated(WindowEvent e) {
        frame.setTitle("激活次數: " + ++count);
    }
});

替代方案：frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 一行搞定關閉退出。

ContentPane 容器

JFrame 本身不是容器，組件必須加到 frame.getContentPane()（默認 BorderLayout）。

三、按鈕家族：JButton、JToggleButton、JCheckBox、JRadioButton

組件	特點	狀態判斷	監聽器
JButton	普通按鈕，點擊觸發動作	無狀態	ActionListener
JToggleButton	切換按鈕，按下/彈起兩態	`isSelected()`	ActionListener
JCheckBox	復選框，勾選/未勾選	`isSelected()`	ItemListener (itemStateChanged)
JRadioButton	單選按鈕，組內互斥	`isSelected()`	ActionListener

單選按鈕必須用 ButtonGroup 管理


ButtonGroup group = new ButtonGroup();
group.add(radio1); group.add(radio2); group.add(radio3);
// 仍需單獨 add 到容器，ButtonGroup 不可視

統一監聽器模式


ActionListener al = e -> {
    Object src = e.getSource();
    if (src == radio1) label.setText("選中 1");
    else if (src == radio2) label.setText("選中 2");
    // ...
};
radio1.addActionListener(al); radio2.addActionListener(al);

四、文本輸入：JTextField、JPasswordField、JTextArea

JTextField：單行，構造指定列數 new JTextField(15)，getText()/setText() 取值賦值。
JPasswordField：繼承 JTextField，setEchoChar('#') 設置掩碼字符，getPassword() 返回 char[]（安全）。
JTextArea：多行，new JTextArea(5, 15) 指定行列，setLineWrap(true) 自動換行，不自帶滾動條，需包裹在 JScrollPane 中。

實時監聽文本變化：CaretListener


textField.addCaretListener(e -> label.setText(textField.getText()));

五、容器與佈局管理：JPanel、JScrollPane、LayoutManager

常用佈局管理器

佈局	特點	典型用法
FlowLayout	左到右、上到下流式排列，類似 Word 文字	簡單表單、工具欄（JPanel 默認）
BorderLayout	東南西北中五區域，每區域最多一組件	主窗口整體結構（JFrame ContentPane 默認）
GridLayout	規則網格，每格一組件	計算器鍵盤、表格式表單
BoxLayout	單行/單列盒子排列	垂直/水平工具欄、側邊欄

佈局實戰：編輯器界面（北部工具欄 + 中部編輯區）


public class EditorFrame extends JFrame {
    public EditorFrame() {
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        // ContentPane 默認 BorderLayout
        JPanel toolBar = new JPanel(); // 默認 FlowLayout
        toolBar.add(new JButton("保存"));
        toolBar.add(new JButton("撤銷"));

        JTextArea editor = new JTextArea(20, 60);
        editor.setLineWrap(true);
        JScrollPane scroll = new JScrollPane(editor); // 自動滾動條

        getContentPane().add(toolBar, BorderLayout.NORTH);
        getContentPane().add(scroll, BorderLayout.CENTER);
        pack();
    }
    public static void main(String[] args) {
        new EditorFrame().setVisible(true);
    }
}

編輯器界面效果圖

JPanel 的作用：作為子容器承載多組件，再作為單一組件加入父佈局

BorderLayout 每區域只能放一組件，若需放多個，先裝入 JPanel（內部用 FlowLayout/BoxLayout），再將 JPanel 放入目標區域。

JScrollPane：讓大組件在固定區域可滾動


JTextArea area = new JTextArea(100, 50); // 內容會無限長
JScrollPane scroll = new JScrollPane(area); // 僅佔父佈局一格，內部可滾動

總結：Swing 入門必記清單

繼承 JFrame，構造器中初始化組件、佈局、監聽器。
組件加到 getContentPane()，注意佈局管理器設置。
事件驅動：addXxxListener + 匿名內部類/Lambda 實現邏輯。
文本組件：JTextField (單行)、JPasswordField (密碼)、JTextArea (多行+JScrollPane)。
單選按鈕必配 ButtonGroup，復選框用 ItemListener。
佈局組合：外層 BorderLayout 分區，內層 JPanel + FlowLayout/BoxLayout 微調。
運行在 EDT (Event Dispatch Thread) 中：SwingUtilities.invokeLater(() -> new MyFrame().setVisible(true))。