Java Swing游戏中KeyListener无响应问题求助

核心问题分析 #

你的代码存在两个关键问题导致KeyListener完全无响应：

1. 重复创建GamePanel实例：Main方法中创建了一个GamePanel，同时GameWindow的构造方法里又新建了另一个GamePanel。窗口中显示的是GameWindow内部的面板，而你启动线程、绑定KeyInput的是Main里的独立面板——两者完全是不同的对象，操作窗口面板自然不会触发任何监听。
2. 焦点未正确获取：即使使用同一个面板，Swing的KeyListener需要组件拥有焦点才能触发事件，仅设置setFocusable(true)不会自动让面板获取焦点。

修复步骤与代码修改 #

1. 统一GamePanel实例 #

修改GameWindow构造方法，接收外部传入的GamePanel，避免重复创建：

import javax.swing.*;

public class GameWindow extends JFrame {
    GameWindow(GamePanel gamePanel) {
        this.setDefaultCloseOperation(EXIT_ON_CLOSE);
        this.setResizable(false);
        this.setTitle("Rycoon Alpha Version 0.1");
        this.setLocationRelativeTo(null);

        this.add(gamePanel);
        this.pack();
        this.setVisible(true); // 最佳实践：先添加组件再设置窗口可见
    }
}

修改Main方法，确保只创建一个GamePanel并传给窗口：

public class Main {
    public static void main(String[] args){
        var gamePanel = new GamePanel();
        var gameWindow = new GameWindow(gamePanel);

        gamePanel.startGameThread();
    }
}

2. 确保面板获取焦点 #

在GamePanel构造方法中添加请求焦点的代码，保证面板能接收键盘事件：

import javax.swing.*;
import java.awt.*;

public class GamePanel extends JPanel implements Runnable{
    // ... 原有常量、成员变量不变 ...

    public GamePanel(){
        this.addKeyListener(keyI);
        this.setPreferredSize(new Dimension(screenWidth,screenHeight));
        this.setBackground(Color.CYAN);
        this.setDoubleBuffered(true);
        this.setFocusable(true);
        this.requestFocusInWindow(); // 添加此行，主动请求焦点
    }

    // ... 原有线程、update、paintComponent方法不变 ...
}

3. 优化按键逻辑（可选） #

当前KeyInput中jumped变量按下后不会重置为false，导致玩家按住W后会一直移动，松开后仍持续。建议在keyReleased方法中重置：

import java.awt.event.KeyEvent;
import java.awt.event.KeyListener;

public class KeyInput implements KeyListener {
    public boolean jumped = false;

    @Override
    public void keyTyped(KeyEvent e) {}

    @Override
    public void keyPressed(KeyEvent e) {
        int code = e.getKeyCode();
        if(code == KeyEvent.VK_W){
            jumped = true;
            System.out.println("hi");
        }
    }

    @Override
    public void keyReleased(KeyEvent e) {
        int code = e.getKeyCode();
        if(code == KeyEvent.VK_W){
            jumped = false; // 松开W后停止移动
        }
    }
}

额外建议：优先使用KeyBindings替代KeyListener #

Swing的KeyListener对焦点依赖很强，而KeyBindings可以在组件没有焦点时也触发事件，更适合游戏场景。例如，给GamePanel绑定W键的按下事件：

// 在GamePanel构造方法中添加
InputMap inputMap = this.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap actionMap = this.getActionMap();

inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_W, 0, false), "jumpPressed");
actionMap.put("jumpPressed", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        keyI.jumped = true;
        System.out.println("hi");
    }
});

inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_W, 0, true), "jumpReleased");
actionMap.put("jumpReleased", new AbstractAction() {
    @Override
    public void actionPerformed(ActionEvent e) {
        keyI.jumped = false;
    }
});

使用KeyBindings时可以移除原有的KeyListener代码，无需关注焦点问题。

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