Java Pong游戏按键监听失效，玩家Paddle无法移动求助

核心问题分析 #

你的代码存在几个关键问题，直接导致键盘输入无法被识别，同时移动逻辑也不符合游戏预期：

1. KeyListener 无法接收事件 #

• Player类是JPanel，但没有被添加到界面组件树中，Board仅创建了Player实例，却未调用add(player)将其加入可视化层级，导致Player无法获得焦点，KeyListener自然接收不到键盘事件。
• 即使添加组件，默认JPanel不会主动请求焦点，需手动设置setFocusable(true)并调用requestFocusInWindow()。

2. 移动逻辑严重错误 #

• Player类keyPressed方法中的for循环会导致按下按键时Paddle瞬间移动大量距离，完全违背平滑移动的游戏逻辑，需移除循环改为单次位置调整。
• Rectangle player的位置不会自动跟随playerYpos更新，初始化后位置固定，需同步更新或直接用playerYpos绘制矩形。

3. 绘制与Timer逻辑混乱 #

• Board的paint方法未调用super.paint(g)，违反Swing绘制规则，会导致画面闪烁或残留。
• Timer的actionPerformed逻辑无意义，仅在切换up/down布尔值，未起到更新Paddle位置的作用。

修复后的代码示例 #

1. Pong主类（调整组件加载顺序） #

import javax.swing.JFrame;

public class Pong {
    Board board = new Board();  

    public void frame() {
        JFrame b = new JFrame("Pong");
        b.setSize(905,705);
        b.setLocation(300,60);
        b.setResizable(false);
        b.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);        
        b.add(board);
        // 先添加组件再设置可见，避免布局异常
        b.setVisible(true);
    }

    public static void main(String[] args) {
        Pong start = new Pong();
        start.frame();
    }
}

2. Board面板类（修复绘制与Timer逻辑） #

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

public class Board extends JPanel{
    public int playerScore = 0;
    public int opponentScore = 0;
    Player player = new Player();
    private Timer timer;
    private final int timeInterval = 10; // 缩短间隔，提升移动平滑度

    public Board() {
        setFocusable(true);
        requestFocusInWindow();
        add(player); // 将Player加入组件树
        timer = new Timer(timeInterval, this::updateGameState);
        timer.start();
    }

    // 定时更新游戏状态
    private void updateGameState(ActionEvent e) {
        player.updatePosition();
        repaint();
    }

    @Override
    public void paintComponent(Graphics g) {
        super.paintComponent(g); // 必须调用父类绘制方法
        Graphics2D g2d = (Graphics2D) g;
        drawGameBoard(g2d);
        // 绘制玩家Paddle
        g2d.setColor(Color.WHITE);
        g2d.fillRect(player.playerXpos, player.playerYpos, player.playerWidth, player.playerHeight);
        // 绘制分数
        g.setFont(new Font("arial",Font.PLAIN,30));
        g.drawString(String.valueOf(playerScore), 20, 35);
        g.drawString(String.valueOf(opponentScore), 855, 35);
    }
    
    private void drawGameBoard(Graphics2D g2d) {
        g2d.setColor(Color.BLACK);
        g2d.fillRect(0, 0, getWidth(), getHeight());
        
        Stroke stroke1 = new BasicStroke(4f);
        g2d.setColor(Color.WHITE);
        g2d.setStroke(stroke1);
        g2d.drawRect(20, 50, 850, 600);
        
        float[] dashingPattern2 = {10f, 4f};
        Stroke stroke2 = new BasicStroke(4f, BasicStroke.CAP_BUTT,
                BasicStroke.JOIN_MITER, 1.0f, dashingPattern2, 0.0f);
        g2d.setStroke(stroke2);
        g2d.drawLine(435, 50, 435, 650);
    }
}

3. Player玩家类（修复键盘监听与移动逻辑） #

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

public class Player extends JPanel implements KeyListener{
    public boolean down = false;
    public boolean up = false;
    public int playerXpos = 45;
    public int playerYpos = 300;
    public int playerWidth = 15;
    public int playerHeight = 80;
    private final int moveSpeed = 5; // 移动速度
    private final int minY = 50; // 顶部边界
    private final int maxY = 650 - playerHeight; // 底部边界（避免Paddle超出画布）

    public Player() {
        setFocusable(true);
        requestFocusInWindow();
        addKeyListener(this);
        setBounds(playerXpos, playerYpos, playerWidth, playerHeight);
        setOpaque(false); // 透明，不遮挡Board的背景绘制
    }

    // 由Timer调用，更新Paddle位置
    public void updatePosition() {
        if (up && playerYpos > minY) {
            playerYpos -= moveSpeed;
            setLocation(playerXpos, playerYpos);
        }
        if (down && playerYpos < maxY) {
            playerYpos += moveSpeed;
            setLocation(playerXpos, playerYpos);
        }
    }

    @Override
    public void keyTyped(KeyEvent e) {}

    @Override
    public void keyPressed(KeyEvent e) {
        if(e.getKeyCode() == KeyEvent.VK_UP) {
            up = true;
        }
        if(e.getKeyCode() == KeyEvent.VK_DOWN) {
            down = true;
        }
    }

    @Override
    public void keyReleased(KeyEvent e) {
        if(e.getKeyCode() == KeyEvent.VK_UP) {
            up = false;
        }
        if(e.getKeyCode() == KeyEvent.VK_DOWN) {
            down = false;
        }
    }
}

关键修复点总结 #

• 将Player添加到Board组件树，确保其在界面上并能获取焦点。
• 改用paintComponent替代paint，并调用super.paintComponent(g)遵循Swing绘制规范。
• 移除keyPressed中的循环，用Timer定时更新位置实现平滑移动。
• 通过keyPressed/keyReleased设置移动状态，而非直接修改位置。
• 添加边界限制，避免Paddle移出游戏区域。

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