Java Swing 鍵盤監聽無響應？焦點機制與 KeyListener 避坑指南

問題現象

在 JPanel 子類中添加 KeyListener，keyTyped 方法內判斷 VK_0 卻無任何控制台輸出。

核心原因：組件未獲得鍵盤焦點

只有擁有鍵盤焦點的組件才能接收鍵盤事件。 JPanel 默認 focusable = false，且未主動請求焦點。

解決方案（三步走）

1. 設置可聚焦：構造器中調用 setFocusable(true)。
2. 請求焦點：組件顯示後（如 addNotify() 或外部調用）執行 requestFocusInWindow()。
3. 使用 Key Bindings 替代 KeyListener（推薦）：Swing 官方推薦機制，不依賴焦點，支援條件觸發。

代碼修正版（KeyListener 版）

public class MyPanel extends JPanel {
    public MyPanel() {
        setFocusable(true);  // 關鍵1
        addKeyListener(new KeyAdapter() {
            @Override
            public void keyPressed(KeyEvent e) {  // 建議用 keyPressed 捕獲功能鍵
                if (e.getKeyCode() == KeyEvent.VK_0) {
                    System.out.println("press 0");
                }
            }
        });
    }

    @Override
    public void addNotify() {
        super.addNotify();
        requestFocusInWindow();  // 關鍵2：加入容器時自動請求焦點
    }
}

進階：Key Bindings 最佳實踐（無焦點煩惱）

public class MyPanel extends JPanel {
    public MyPanel() {
        // 1. 定義動作
        Action pressZero = new AbstractAction() {
            @Override public void actionPerformed(ActionEvent e) {
                System.out.println("press 0 via Key Bindings");
            }
        };

        // 2. 綁定鍵盤觸發條件：WHEN_IN_FOCUSED_WINDOW = 窗口焦點時生效（不要求組件焦點）
        InputMap im = getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
        ActionMap am = getActionMap();

        im.put(KeyStroke.getKeyStroke(KeyEvent.VK_0, 0), "pressZero");
        am.put("pressZero", pressZero);
    }
}

KeyListener vs Key Bindings 對比

常見坑

• keyTyped 無法捕獲功能鍵（F1、方向鍵、修飾鍵），必須用 keyPressed/keyReleased。
• 多組件搶焦點：確保目標組件 requestFocusInWindow() 最後調用，或用 FocusTraversalPolicy 控制順序。
• 彈窗/對話框彈出會搶走焦點，導致主面板失效，Key Bindings 可避免此問題。

拋棄 KeyListener，擁抱 Key Bindings，徹底告別「焦點丟失導致鍵盤無響應」的歷史包袱。