Swing使用CardLayout切换界面后GameBoard JPanel无法接收键盘事件

问题根因 #

KeyListener 仅在绑定的组件持有当前窗口焦点时才能触发事件。你新增欢迎界面之前，GameBoard是窗口唯一的内容面板，窗口初始化时会自动将焦点分配给它，所以按键监听正常工作。新增欢迎界面后，窗口初始化时焦点落在欢迎页的可交互组件（如按钮）上，调用cl.show()切换到游戏面板时，焦点不会自动转移到GameBoard上，因此你绑定的KeyAdapter收不到任何按键事件。

修复方案 #

快速修复：切换卡片后主动给GameBoard分配焦点 #

你只需要在切换到游戏面板的逻辑后，主动让GameBoard请求焦点即可：

1. 首先调整Main.java中初始化Welcome的逻辑，将GameBoard实例传入Welcome：

// 修改前
// welcomeMenu = new Welcome(cardLayout, mainPanel);
// 修改后
welcomeMenu = new Welcome(cardLayout, mainPanel, game);

2. 在Welcome类中新增GameBoard类型的成员变量接收传入的实例，然后修改PLAY按钮的事件处理逻辑：

@Override
public void actionPerformed(ActionEvent evt) {
    if (evt.getActionCommand() == Actions.EXIT.name()) {
        System.exit(0);
    } else if (evt.getActionCommand() == Actions.CONFIG.name()) {
        JOptionPane.showMessageDialog(null, "Not yet implemented");
    } else if (evt.getActionCommand() == Actions.PLAY.name()) {
        cl.show(mp, "game");
        // 新增一行，主动给GameBoard分配焦点，requestFocusInWindow比requestFocus跨平台兼容性更好
        game.requestFocusInWindow();
    }
}

如果不想在多个类之间传递GameBoard引用，也可以在GameBoard内部监听自身显示事件，显示时自动请求焦点：
在GameBoard的initBoard()方法中添加以下代码：

addComponentListener(new ComponentAdapter() {
    @Override
    public void componentShown(ComponentEvent e) {
        requestFocusInWindow();
    }
});

更稳定的方案：使用键绑定（Key Bindings）替代KeyListener #

KeyListener严格依赖组件焦点，对于游戏这类需要全局响应按键的场景，Swing的键绑定机制更稳定，只要窗口处于激活状态就能响应按键，不需要组件持有焦点。
你可以在GameBoard的initBoard()方法中按以下逻辑替换原有的KeyListener：

// 移除原来的addKeyListener(new TAdapter())代码，替换为以下逻辑
InputMap inputMap = getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap actionMap = getActionMap();

// 绑定左方向键
inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_LEFT, 0), "moveLeft");
actionMap.put("moveLeft", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        if (inGame) {
            req_dx = -1;
            req_dy = 0;
        }
    }
});

// 绑定右方向键
inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_RIGHT, 0), "moveRight");
actionMap.put("moveRight", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        if (inGame) {
            req_dx = 1;
            req_dy = 0;
        }
    }
});

// 按同样逻辑绑定上、下、ESC、暂停等其他按键即可

这种方案不需要处理焦点逻辑，后续如果再新增其他卡片页面也不会影响游戏按键的响应。

内容的提问来源于stack exchange，提问作者Dev Yego