为什么我的Java Swing程序中JMenuItem无法响应KeyEvent按键事件？

• JMenuItem 是专为 JMenu/JMenuBar 菜单体系设计的组件，脱离菜单父容器时，默认UI实现不会分发MenuKeyEvent，也无法正常响应ActionListener、普通按键事件，所有交互逻辑依赖菜单父组件的事件调度。
• 现有代码未设置初始焦点，窗口加载后焦点不会自动落在第一个选项上，按键自然无法触发对应逻辑。

直接替换JMenuItem为JButton，JButton无多余的菜单类无障碍角色，事件响应逻辑独立，完全满足你的需求，修改后的可运行代码如下：

import java.util.Set;
import java.util.HashSet;
import javax.swing.*;
import java.awt.*;
import java.awt.event.*;

public class Screen {

    public Screen() {
        // 初始化Swing组件放在EDT线程执行，避免线程安全问题
        SwingUtilities.invokeLater(() -> {
            // 配置上下方向键为焦点遍历键
            Set<AWTKeyStroke> forwardKeys = new HashSet<>(KeyboardFocusManager.getCurrentKeyboardFocusManager().getDefaultFocusTraversalKeys(KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS));
            forwardKeys.add(KeyStroke.getKeyStroke("DOWN"));
            KeyboardFocusManager.getCurrentKeyboardFocusManager().setDefaultFocusTraversalKeys(KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, forwardKeys);
            
            Set<AWTKeyStroke> backwardKeys = new HashSet<>(KeyboardFocusManager.getCurrentKeyboardFocusManager().getDefaultFocusTraversalKeys(KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS));
            backwardKeys.add(KeyStroke.getKeyStroke("UP"));
            KeyboardFocusManager.getCurrentKeyboardFocusManager().setDefaultFocusTraversalKeys(KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, backwardKeys);
            
            // 用JButton替代JMenuItem，无多余无障碍角色
            JButton mi = new JButton("play");
            JButton mi2 = new JButton("exit");
            mi.setFocusable(true);
            mi2.setFocusable(true);
            
            // 按键监听
            mi.addKeyListener(new KeyAdapter() {
                @Override
                public void keyReleased(KeyEvent e) {
                    System.out.println("Play released");
                }
            });
            // 点击/回车/空格都会触发ActionListener
            mi.addActionListener(e -> {
                System.out.println("进入游戏");
            });
            
            mi2.addActionListener(e -> System.exit(0));
            
            JPanel mp = new JPanel();
            mp.setLayout(new BoxLayout(mp, BoxLayout.Y_AXIS)); // 竖向排列更符合菜单样式
            mp.add(mi);
            mp.add(mi2);
            
            JFrame mf = new JFrame("Game");
            mf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            mf.add(mp);
            mf.pack();
            mf.setLocationRelativeTo(null);
            mf.setVisible(true);
            
            // 设置初始焦点在第一个选项
            mi.requestFocusInWindow();
        });
    }
    
    public static void main(String args[]) {
        new Screen();
    }
}

如果需要和JMenuItem一致的视觉样式，直接给JButton设置对应样式即可：

// 示例：把按钮调成菜单项样式
mi.setBorderPainted(false);
mi.setContentAreaFilled(false);
mi.setFocusPainted(true);
mi.setHorizontalAlignment(SwingConstants.LEFT);

如果必须保留JMenuItem组件，你需要自己注册全局按键分发器，手动转发事件给焦点组件，同时给JMenuItem添加普通KeyListener和绑定回车/空格触发ActionListener，事件转发的代码示例如下：

KeyEventDispatcher keyDispatcher = e -> {
    Component focusOwner = KeyboardFocusManager.getCurrentKeyboardFocusManager().getFocusOwner();
    if (focusOwner instanceof JMenuItem && focusOwner.isShowing()) {
        // 手动转发按键事件给当前焦点的JMenuItem
        focusOwner.dispatchEvent(e);
        // 处理回车/空格触发ActionListener
        if (e.getID() == KeyEvent.KEY_RELEASED && (e.getKeyCode() == KeyEvent.VK_ENTER || e.getKeyCode() == KeyEvent.VK_SPACE)) {
            ((JMenuItem) focusOwner).doClick();
        }
        return true;
    }
    return false;
};
KeyboardFocusManager.getCurrentKeyboardFocusManager().addKeyEventDispatcher(keyDispatcher);

使用该方案同样需要添加初始焦点请求代码，否则窗口加载后无焦点。

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