swing游戏主循环须用javax.swing.timer而非thread.sleep()避免edt阻塞；绘制需重写paintcomponent()并调用super；键盘响应应使用keybinding绑定到when_in_focused_window；资源加载须在edt外异步完成并捕获ioexception。
Swing 游戏主循环不能靠 Thread.sleep() 主动阻塞 EDT
Swing 的事件分发线程（EDT）负责绘制和响应用户操作，一旦被长时间阻塞（比如在 while(true) 里调用 Thread.sleep(16)），界面立刻冻结、按钮点不动、窗口拖拽卡死——这不是“游戏慢”，而是整个 GUI 挂了。
正确做法是用 javax.swing.Timer 驱动游戏逻辑帧：
Timer timer = new Timer(16, e -> {
updateGameLogic(); // 更新位置、碰撞、状态
repaint(); // 触发 paintComponent()
});
timer.start();
-
16是约 60 FPS 的间隔（单位毫秒），数值越小帧率越高，但别低于 8（否则 EDT 负载过重） - 监听器里不能做耗时操作（如读文件、网络请求），否则仍会卡 UI
- 如果需要更精确的帧控制（比如物理模拟），得把逻辑时间与渲染分离，但小型游戏用
Timer完全够用
自定义绘制必须继承 JPanel 并重写 paintComponent(Graphics g)
别在 paint() 或顶层容器上硬画——Swing 的双缓冲、脏矩形优化、组件层级叠加都依赖 paintComponent() 的标准流程。
常见错误包括：
立即学习“Java免费学习笔记（深入）”；
- 忘记调用
super.paintComponent(g)→ 背景残留、旧图形不擦除 - 在
paintComponent()里创建新对象（如new Font()、new BufferedImage()）→ 每帧 GC 压力大，掉帧明显 - 直接用
getGraphics()获取画布 → 返回的可能是过期或 null 的 Graphics，且绕过 Swing 绘制机制
正确结构示例：
@Override
protected void paintComponent(Graphics g) {
super.paintComponent(g);
Graphics2D g2d = (Graphics2D) g;
g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
drawPlayer(g2d);
drawEnemies(g2d);
}
键盘输入要用 KeyBinding，别依赖 KeyListener
KeyListener 要求组件有焦点且可聚焦，而游戏里玩家频繁点击按钮、切换窗口后焦点丢失，keyPressed 突然失效，非常难排查。
InputMap + ActionMap（即 KeyBinding）绑定到根面板，能确保按键全局响应：
InputMap im = gamePanel.getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW);
ActionMap am = gamePanel.getActionMap();
im.put(KeyStroke.getKeyStroke("LEFT"), "moveLeft");
am.put("moveLeft", new AbstractAction() {
public void actionPerformed(ActionEvent e) {
player.x -= 5;
}
});
-
WHEN_IN_FOCUSED_WINDOW是关键，它让绑定在窗口获得焦点时就生效，不依赖具体组件聚焦 - 方向键、空格等常用键建议用字符串描述（如
"UP"、"SPACE"），比KeyEvent.VK_UP更易读 - 记得在游戏暂停时禁用 ActionMap（
am.clear()），否则暂停中还能移动角色
资源加载失败时，ImageIO.read() 抛 IOException 而非返回 null
新手常写 if (img == null) 判断图片是否加载成功，但 ImageIO.read() 在路径错、格式不支持、权限不足时直接抛异常，img 根本不会是 null——结果程序崩溃，还找不到原因。
必须显式捕获：
try {
playerImg = ImageIO.read(getClass().getResource("/images/player.png"));
} catch (IOException e) {
e.printStackTrace(); // 或显示错误提示
playerImg = createPlaceholderImage(); // 提供 fallback
}
- 路径用
/images/...表示从 classpath 根开始，别用相对路径（"images/player.png"）——打包成 JAR 后一定失败 - 资源放在
src/main/resources（Maven 结构）或与 class 同级的resources文件夹下 - 首次加载后缓存
BufferedImage对象，别每帧都ImageIO.read()
小游戏中最易忽略的是资源加载时机：务必在 Swing 事件线程外完成（比如启动时单独线程加载），否则初始化窗口就卡住几秒，用户以为程序假死。
