本文详解为何 keyPressed() 和 keyReleased() 未被触发，并提供标准、可靠的解决方案：将 KeyListener 绑定到可聚焦的底层组件（如 Canvas）而非 JFrame，同时确保组件已获取焦点并正确处理键盘事件。
本文详解为何 `keypressed()` 和 `keyreleased()` 未被触发，并提供标准、可靠的解决方案：将 `keylistener` 绑定到**可聚焦的底层组件（如 `canvas`）而非 `jframe`**，同时确保组件已获取焦点并正确处理键盘事件。
在 Swing 中，KeyListener 只有在目标组件具有输入焦点（focus）且处于可聚焦（focusable）状态时才会响应按键事件。你当前的代码将 KeyListener 添加到了 JFrame 上，但 JFrame 默认不可聚焦（isFocusable() 返回 false），且其内容窗格（content pane）或子组件（如 Canvas）会抢占焦点——导致 JFrame 的监听器永远无法被调用。
根本原因在于：Swing 的键盘事件路由机制遵循“焦点组件优先”原则。即使你调用了 frame.setFocusable(true)，JFrame 本身极少获得焦点（尤其当其内含 Canvas 等重量级组件时），因此监听器形同虚设。
✅ 正确做法是：将 KeyListener 添加到实际接收用户输入的组件上（即 Canvas 实例），并显式设置其可聚焦性与请求焦点。
以下是修正后的关键代码（仅展示需修改部分）：
// 在 Window.java 的构造函数中，替换原 frame.addKeyListener(...) 部分：
frame.add(display); // 先添加 Canvas
display.setFocusable(true); // ✅ 关键：使 Canvas 可聚焦
display.requestFocusInWindow(); // ✅ 关键：立即请求焦点（确保启动时生效）
// ✅ 将 KeyListener 绑定到 display（即 Canvas），而非 frame
display.addKeyListener(new KeyListener() {
@Override
public void keyTyped(KeyEvent e) {}
@Override
public void keyPressed(KeyEvent e) {
char c = e.getKeyChar();
// 注意：KeyEvent.getKeyChar() 对功能键（如 Ctrl、Shift）可能返回 '\u0000'
// 更健壮的做法是使用 e.getKeyCode()
if (c != KeyEvent.CHAR_UNDEFINED && !keysDown.contains(c)) {
keysDown.add(c);
}
}
@Override
public void keyReleased(KeyEvent e) {
char c = e.getKeyChar();
if (c != KeyEvent.CHAR_UNDEFINED) {
keysDown.remove((Object) c);
}
}
});同时，在 Game.java 的 init() 方法中，确保 Canvas 已完成初始化后再设置焦点（上述 requestFocusInWindow() 已覆盖此需求）。若仍遇到焦点丢失问题（例如点击窗口其他区域后失效），可在 Canvas 上添加鼠标点击监听器主动重获焦点：
// 在 Window.java 中，于 display.addKeyListener(...) 后添加：
display.addMouseListener(new MouseAdapter() {
@Override
public void mousePressed(MouseEvent e) {
display.requestFocusInWindow();
}
});⚠️ 重要注意事项：
- 避免使用 getKeyChar() 判断功能键：keyPressed() 中 getKeyChar() 对 Arrow、Ctrl、Shift 等返回 '\u0000'。如需检测方向键或修饰键，请改用 e.getKeyCode()（如 KeyEvent.VK_LEFT）。
- 线程安全：keysDown 是 LinkedList，在多线程（如渲染线程调用 getKeysDown()）中直接读写存在风险。建议改为 Collections.synchronizedList(new LinkedList()) 或使用 CopyOnWriteArrayList。
- 资源清理：若需动态移除监听器，记得保存 KeyListener 引用以便后续 removeKeyListener()。
总结：Swing 键盘事件调试的核心是 “谁聚焦，谁响应”。始终将 KeyListener 绑定到明确可聚焦、且用户实际交互的组件（如 JPanel、Canvas），并通过 setFocusable(true) + requestFocusInWindow() 主动管理焦点，即可彻底解决监听器不触发的问题。
