简介在Java图形界面开发领域Swing是构建桌面小游戏最经典的框架之一。游戏循环的稳定性、物理模拟的真实性以及碰撞检测的精准度共同决定了一款休闲游戏的体验质量。通过剖析基于Swing Timer的定时刷新机制、重力加速度与跳跃初速度的数值模型、矩形相交判定算法可以系统掌握Java游戏开发的底层逻辑。这类知识不仅适用于飞行躲避类游戏也能迁移到其他2D小游戏的工程实践中。本文从工程结构、资源加载、主循环设计、碰撞优化到手感调参完整拆解一个可运行的飞翔的小鸟JAVA版游戏案例帮助初学者避开图片路径失效、画面闪烁、键盘焦点丢失等典型陷阱并给出难度曲线的扩展思路。1. 飞翔的小鸟 Java 版一份能跑的完整代码到底包含什么从搜索框敲下「java 飞翔的小鸟 游戏 编程」的人一半是课程设计要交 Demo 的学生一半是刚啃完 Java 基础想找个完整案例练手的新手。这两类人最常见的翻车现场一模一样资源下载后一运行图片路径报 NPE、中文乱码、键盘没反应只能对着报错干瞪眼。这份飞翔的小鸟代码完整版java 版的价值不在于画面多精致而是把 Swing 小游戏必需的骨架凑齐了——游戏循环、重力模拟、随机管道、碰撞检测、计分与状态切换。它纯 JDK 自带库实现不用 Maven 拉依赖、不用配特殊环境解压就能跑。学生党拿它当课程设计骨架改改界面交作业初学者把它当源码教材每读一个类事件监听和面向对象这两块就算真落地了。2. 运行环境与工程结构JDK 怎么选、资源文件放哪这类 Swing 小游戏对 JDK 版本非常不敏感但「能用」和「省心」是两码事。我先说结论首选 JDK 8。原因有两个一是绝大多数课程设计和老教材都以 JDK 8 为目标环境很多网传代码根本没按模块系统拆分JDK 9 以后直接用 javac 编译会出现模块访问报错二是 JDK 8 的 javax.swing 不需要额外配置而 JDK 9 如果按模块化方式管理工程还得在 module-info.java 里补 requires java.desktop 这类声明。如果你机器上已经装了 JDK 17 也没关系普通 classpath 工程照样能跑但与其排查模块问题不如直接装一个 JDK 8 来得稳。至于下载渠道去 java 官网 jdk 下载页面选一个 8u 的 Windows/Linux 安装包就行。IDE 我一般推荐 IntelliJ IDEA Community 版Eclipse 的工作空间概念对刚入门的人是个不必要的负担。用 IDEA 打开代码包时只需要把它当成普通 Java 工程导入不要选 Maven/Gradle 模板因为这份代码根本不需要那套依赖管理。这里顺带说一句凡是需要你配一堆 plugin 和 dependency 才跑得起来的小游戏本身就是工程化过度纯 Swing 代码正确的打开方式就是「一个 JDK、一个 IDE、一个入口类」。2.1 JDK 版本与 IDE 选型JDK 版本的坑值得再展开一点。很多人用 JDK 17 跑 8 写的代码遇到 javax.swing 相关编译错误第一反应是代码有问题其实多半是模块化的问题。下面这个表格是我实际遇到的几种情况场景JDK 8JDK 11建议javac 直接编译无模块限制直接过报 package javax.swing is not visible加 --add-modules java.desktop 或换 8IDEA 普通工程无感知无感知两者都行打包成可执行 jar正常需在 MANIFEST 处理优先 8其实就算报错也有后悔药在 javac 后面加一句 --add-modules java.desktop 就能编过或者在 IDEA 里把 Module 的依赖加上 java.desktop。但是这门课如果老师要求的就是 JDK 8 环境你没必要给自己找事直接统一版本最省事。判断代码包到底是哪个 JDK 写的有个土办法看代码里有没有用 var 关键字或者 record 这类明显的新语法有就是 11没有就默认 8 处理。2.2 工程目录与入口类职责下载解压后先别急着点运行花两分钟把目录结构认一遍。这类 Swing 小游戏普遍是单线程多类设计典型的目录长这样flappy-bird/ ├── src/ │ ├── GameFrame.java # 入口创建窗口并启动游戏 │ ├── GamePanel.java # 画布主循环、绘制、碰撞检测 │ ├── Bird.java # 小鸟实体坐标、速度、跳跃逻辑 │ ├── Pipe.java # 管道实体位置、间隙、移动逻辑 │ └── res/ │ ├── bg.png # 背景图 │ ├── bird.png # 小鸟图 │ └── pipe.png # 管道图 └── out/ # 编译输出目录首次编译后生成这份结构里最容易被新手忽略的是 res 目录。它必须放在 src 根下而不是和 src 平级也不是随便放哪都行因为后面代码里加载资源走的是 classpath而 src 根目录在编译后会变成 classpath 根目录。资源放在 src/res 下就意味着 classpath 根目录下会有一个 res 文件夹getResource(/res/bg.png) 才能找到。入口类的职责也要说清楚main 方法放在 GameFrame 里只做三件事——创建 JFrame、把 GamePanel 塞进去、调用 start() 启动主循环。凡是看到 main 方法里又写窗口又写游戏逻辑又写图片加载的代码读起来会很痛苦你接手后第一件事就是把它拆开。完整版代码如果作者没拆你自己按这个结构拆一遍也是一个非常好的重构练习。2.3 素材不走相对路径图片资源的三条放置规则接下来是资源加载这是 Swing 小游戏里最常见的翻车点。很多初版代码喜欢写ImageIO.read(new File(src/res/bg.png))这种写法在 IDE 里碰巧能跑但只要你把工程打包成 jar 分给别人立刻找不到文件。正确姿势是走 classpath// 错误示例用文件系统相对路径打包即失效 // Image bg ImageIO.read(new File(src/res/bg.png)); // 正确写法一getResource 返回 URL适合图片这类资源 Image bg ImageIO.read(GamePanel.class.getResource(/res/bg.png)); // 正确写法二getResourceAsStream 返回流适合配置文件或网络环境 // Image bg ImageIO.read(GamePanel.class.getResourceAsStream(/res/bg.png));重点解释两个细节。第一是路径前那个反斜杠不是随手的它表示从 classpath 根目录开始找没有它就是在当前类所在包下找包名一复杂就出错。第二是 getResource 返回 URL如果资源不存在会返回 nullImageIO.read(null) 不会给你一个亲切的「文件不存在」提示而是直接抛 NPE所以很多人看到 NPE 以为是小鸟对象没初始化其实是图片没加载到。习惯上我会把资源加载写成一个静态方法统一处理 null 和抛异常public static Image loadImage(String path) throws IOException { URL url GamePanel.class.getResource(path); if (url null) { throw new IOException(资源不存在: path); } return ImageIO.read(url); }这层包装有两个好处。一是报错信息可读资源路径写错了能立刻看出来是哪个文件的问题二是后续代码里所有图片加载都走这一个入口不会出现一个类用 File、一个类用 getResource 的混乱局面。你拿到完整版代码后如果发现里面有用到 ImageIO.read 的地方建议全部统一成这种写法能省掉后面反复排查资源问题的力气。3. 核心代码拆解游戏循环、重力模型与碰撞判定的实现这一章是整份代码最值钱的部分。很多所谓「完整版」代码功能是能跑但读起来一团乱麻——一个类里又画背景又管碰撞又算分数你根本没法改。合格的做法是把每一块职责拆开然后用一条主循环把它们串起来。下面我按「循环怎么转、小鸟怎么跳、管道怎么来、碰撞怎么判」四个问题来讲你拿着完整代码对照着看很快就能定位到对应的方法。3.1 游戏主循环Swing Timer 为什么比线程 sleep 稳小游戏和普通业务系统最大的区别就是有一个「每帧都在转」的主循环。Java 里做循环有三种常见方案但适合 Swing 的只有一个用 javax.swing.Timer。public class GamePanel extends JPanel { private static final int FRAME_INTERVAL 16; // 毫秒约 60 FPS private Bird bird; private ListPipe pipes; private Timer timer; public GamePanel() { bird new Bird(100, 300); pipes new LinkedList(); // Timer 的回调在 EDT 线程执行能安全操作 Swing 组件 timer new Timer(FRAME_INTERVAL, e - { bird.update(); for (Pipe pipe : pipes) { pipe.move(); } checkCollision(); repaint(); // 请求重绘paintComponent 会被调用 }); } public void start() { timer.start(); } }这段代码逻辑不复杂但有一个知识点值得停下来想清楚为什么不能用while (true) { ... Thread.sleep(16); repaint(); }因为 Swing 的组件有一套自己的线程模型所有 UI 更新必须在事件分发线程EDT上执行。你在普通子线程里调用 repaint()轻则画面不刷新重则界面卡死这是 Swing 开发的铁律。Timer 的设计目标就是解决这个问题它的回调天然跑在 EDT 上所以在回调里改 bird、改 pipes、调 repaint 都是安全的。FRAME_INTERVAL 参数是控制帧率的关键把 16 改成 25 就是 40 FPS改成 33 就是 30 FPS。帧率低的小游戏画面会肉眼可见地一顿一顿所以一般不要低于 30。这里还要提一句如果你看到代码里用的是 java.util.Timer 或 new Thread sleep那这个版本大概率会有闪烁或者卡顿问题参照这一节改成 Swing Timer 就行。3.2 重力与跳跃两个参数决定一套手感小鸟的飞行手感本质是两个数字的组合重力和跳跃初速度。这是物理模拟里最简化的版本不考虑加速度曲线只用匀变速直线运动对初学者来说完全够用。public class Bird { private double x, y; // 坐标 private double velocity; // 垂直速度单位像素/帧 private final double gravity 0.3; // 重力加速度每帧速度增加量 private final int radius 15; // 绘制半径供 paintComponent 使用 public Bird(int x, int y) { this.x x; this.y y; } // 玩家按空格触发一次扇翅 public void flap() { velocity -6.5; // 负值表示向上绝对值决定跳跃力度 } // 每一帧都调用 public void update() { velocity gravity; // 速度逐帧增加模拟重力加速 y velocity; // 速度叠加到坐标上 } }理解这段代码有一个先后顺序要绕明白先改速度再改坐标。flap() 直接把速度设成 -6.5相当于给小鸟一个瞬间向上的冲量之后每一帧 update() 先让速度朝正方向向下增加 0.3再把速度叠到 y 坐标上。所以小鸟的轨迹是「快速上升 → 到达顶点 → 加速下落」整体是一条抛物线。想调整手感只需要改两个数字gravity 越大小鸟坠得越快操作越急躁flap 的绝对值越大每次跳跃抬升越高。我自己调试的时候习惯把 gravity 调到 0.25、flap 调到 -7这样跳跃更有韧性一点接近原版 Flappy Bird 的节奏。如果你的画布是 600 像素高gravity 0.3 搭配 flap -6.5 大约能让小鸟跳起 70 像素这个幅度在管道间隙 140 像素的场景下刚好能过关数值选得太大反而让游戏变得太简单。3.3 管道生成与移动链表容器与随机间隙管道和背景不一样它需要无限生成但又不能无限创建对象否则内存和 GC 都会横插一脚。常见做法是用一个链表装所有「活着」的管道不停地从右侧生成、左侧移除。这正好是一个 Java 容器使用的标准场景。public class Pipe { public static final int WIDTH 60; // 管道宽度 public static final int GAP_HEIGHT 140; // 上下管道之间的间隙 private static final int SPEED 2; // 每帧左移像素 private int x; // 管道左侧 x 坐标 private int gapCenter; // 间隙中心的 y 坐标 public Pipe(int startX, int gapCenter) { this.x startX; this.gapCenter gapCenter; } public void move() { x - SPEED; } public boolean isOffScreen() { return x WIDTH 0; // 完全移出屏幕左侧说明可以回收 } public int getGapTop() { return gapCenter - GAP_HEIGHT / 2; } public int getGapBottom() { return gapCenter GAP_HEIGHT / 2; } }gapCenter 的随机生成范围直接决定游戏难度。如果画布高度是 600背景地面大约在 520 的位置那么 gapCenter 在 180 到 380 之间随机比较合理——太靠上小鸟容易撞地太靠下小鸟要飞很高才够得着。生成和管理这些管道我一般会在 GamePanel 里维护一个 LinkedList 每帧移动管道并检查状态private void spawnAndRecyclePipes() { // 只有当最新一根管道已经走到画布中央偏右时才生成下一根 if (pipes.isEmpty() || pipes.getLast().getX() getWidth() - 260) { pipes.add(new Pipe(getWidth(), 180 new Random().nextInt(200))); } // 移除已经离开屏幕的管道 pipes.removeIf(pipe - pipe.isOffScreen()); }这里有两个参数值得记一下。260 是相邻管道的水平间距间距太小会导致连续两个间隙叠在一起玩家根本没有反应时间间距太大游戏会显得空旷。180 nextInt(200) 是随机范围也就是 gapCenter 在 180380 之间波动你也可以根据自己对难度预期改成 150 nextInt(260) 之类。removeIf 这一步看着简单少了它管道 List 会无限膨胀几十分钟后游戏就会明显变卡。3.4 碰撞检测矩形相交与上下边界碰撞检测的实现可以直接决定玩家对游戏的评价——明明没撞上却死了比难还让人恼火。Swing 提供的 Rectangle 类自带 intersects 方法所以绝大多数实现都把它拆成两个矩形来碰撞。private void checkCollision() { Rectangle birdBox bird.getCollisionBox(); // 内缩后的碰撞盒 for (Pipe pipe : pipes) { // 上管道从画布顶部到间隙上沿 Rectangle upperBox new Rectangle(pipe.getX(), 0, Pipe.WIDTH, pipe.getGapTop()); // 下管道从间隙下沿到画布底部 Rectangle lowerBox new Rectangle(pipe.getX(), pipe.getGapBottom(), Pipe.WIDTH, getHeight() - pipe.getGapBottom()); if (birdBox.intersects(upperBox) || birdBox.intersects(lowerBox)) { gameOver(); return; } } // 上下边界飞出屏幕也算失败 if (bird.getY() 0 || bird.getY() GROUND_Y) { gameOver(); } }碰撞判定分三层每一层都有讲究。第一层是拆成上下两个矩形上管道从 y0 到间隙上沿下管道从间隙下沿到画布底这样用一个循环就能同时检测两根管子。第二层是 birdBox 必须用内缩后的碰撞盒这一点放到第 5 章避坑里详细说这里先记住结论图片 60x60碰撞盒用 30x30 的矩形才接近真实边界。第三层是上下边界用坐标直接判断而不是再建矩形因为撞到天花板不一定要碰撞盒y 0 就足够准确。这里还要提醒一个隐藏 bug管道通过小鸟之后如果不加标记检查循环里依然会检测这根管道但此时小鸟已经飞到管道左边矩形不重叠不影响游戏。真正的隐患是加分逻辑——如果写的是「每根管道经过一次加分」没有标记的话重复判断会导致分数一次加多次。完整代码里一般会写一个 hasPassed 字段你在读代码的时候可以重点找一下。4. 把代码跑起来导入、编译、操作与三处手感调参前面把代码结构讲完了这一章解决「怎么让它真的跑起来」。老实说一个纯 Swing 的 Java 小游戏运行方式简单到没有悬念要么 IDE 里点运行按钮要么命令行 javac/java 两连。下面把两种方式都写一遍再附上操作逻辑和我常用的三处调参位置。4.1 命令行编译与运行先给不喜欢开 IDE 或者想在 Linux 服务器上验证的同学。假设你已经把代码解压到 flappy-bird 目录并且 JDK 8 已经加到 PATH 里那么cd flappy-bird # 编译所有源码到 out 目录-encoding 防止 Windows 下中文注释乱码 javac -encoding UTF-8 -d out src/*.java # 运行入口类-cp 指定 classpath 根目录为 out java -cp out GameFrame这里的 -encoding UTF-8 是我特别叮嘱的。Windows 控制台默认编码是 GBK或者新系统里的代码页 936如果源码文件本身是 UTF-8 保存的不加这个参数注释和字符串里的中文就会变成乱码严重的时候直接编译报错「非法字符」。加了之后编译阶段不再有编码问题。另外注意 javac 和 java 是连着两步很多人只编译不运行或者编译完忘了 -cp out结果报「找不到或无法加载主类 GameFrame」这一类问题第 5 章再系统讲。还有个常见变体是代码包里直接带了 run.bat 这种启动脚本。脚本意思是一样的但内容多半写的是java -jar flappy-bird.jar或者java -cp src GameFrame。前者需要先把资源打包进 jar后者 classpath 指向 src 会让 IDE 工程和命令行混在一起新手直接双击大概率起不来。我拿到这类脚本的习惯是先看懂里面两个路径参数改成java -cp out GameFrame再执行。4.2 IDEA 导入与启动用 IDEA 打开这个工程也有一个容易忽略的细节导入的时候不要选 Maven 或 Gradle 模板。步骤是 File → New → Project from Existing Sources → 选中解压目录 → 保持默认 Create project from existing sources → 下一步时把 JDK 选成 8 → 完成。IDEA 会自己识别 src 目录为源码根目录res 目录如果没自动识别为资源根目录你需要右键 res 目录 → Mark Directory as → Resources Root。代码在不同 JDK 之间切换也有讲究。如果导入后右下角提示 JDK 版本不对就到 Project Structure → Project 里把 SDK 切到 8Modules 页签里同样确认一下 Language level 选 8。做完这两步一般就不会出现「代码里用了 List.of 之类新 API编译却报错」的尴尬。启动时直接选中 GameFrame点旁边的绿色运行按钮即可。4.3 操作逻辑与游戏状态切换跑起来以后交互逻辑非常简单按空格起跳。但这份代码里的游戏状态切换值得单独讲因为它在几乎所有同类小游戏中都是模板级的存在。public enum GameState { READY, RUNNING, OVER } private void handleKeyPress(KeyEvent e) { if (e.getKeyCode() ! KeyEvent.VK_SPACE) { return; } switch (state) { case READY: case OVER: resetGame(); // 重置小鸟位置、清空管道、分数归零 state GameState.RUNNING; timer.start(); break; case RUNNING: bird.flap(); break; } }三个状态把游戏生命周期分得很干净READY 是启动等待画面此时按空格开始RUNNING 是正常游戏空格触发跳跃OVER 是碰撞后的结束画面再按空格则是重开。用枚举而不是 int 常量来表示状态在业务代码里也是好习惯它的好处是编译器会帮你检查不会出现 state 2 这种魔法数字没人读得懂的问题。值得注意的是 READY 和 OVER 两个状态共用了一段重置逻辑这是刻意的。死完直接重开不需要玩家再点一次鼠标或回车符合这类小游戏的交互习惯。如果你想把「死后必须再等一秒才能重开」加进去可以在 OVER 状态里加一个时间戳判断简单但有效。4.4 手感调参gravity、flap 和 gapHeight游戏能跑只是第一步手感才是决定它是否「好玩」的关键。这份完整版代码里的几个参数分别控制坠落速度、跳跃高度和通过难度对应关系如下参数位置常见值调整方向与影响gravityBird 类字段0.3越大坠落越快操作需要更频繁flap 初速度Bird.flap() 中-6.5绝对值越大跳得越高pipeSpeedPipe 类常量2越大整体游戏节奏越快gapHeightPipe 类常量140越小越难钻越大越简单调参最忌讳一次性乱改。我的做法是每次只改一个参数跑三局感受差别后再动下一个。先调 flap 初速度让自己觉得「跳得起来」再调 gravity 找到「坠落不飘不坠」的中间值最后调 gapHeight 和管道速度控制难度。如果改了 Bird 里的参数发现没有生效先检查是不是有多个 Bird 类文件——有些版本会把旧类留在同包下面IDE 编译时用了旧的。这一章说完整理完其实还缺一个验证手感的自动化手段放到最后一章专门讲这里先不展开。5. 避坑指南启动失败、画面闪烁、按键不灵的五个常见问题运行这一类 Swing 小游戏 Demo新手踩坑的概率比想象中高很多而且坑位非常集中。这一章把我拆过多个 Java 小游戏代码后最常遇到的五个问题按「现象 → 原因 → 解决」写出来每条都可以直接对照着排查。5.1 图片加载失败报错 NPE 的根源是资源路径现象窗口能弹出来背景和小鸟全部是空白控制台抛 NullPointerException定位到 ImageIO.read 那行。原因图片路径写错或资源目录没被识别。多数初版代码用的是new File(src/res/bg.png)这种相对路径它依赖「当前工作目录」恰好是工程根目录只要启动方式一变比如从命令行 java -cp out 启动路径立刻失效。还有一种情况是 IDEA 里 res 目录没有被标成 Resources Root编译后 classpath 里根本没有 res 文件夹。解决把资源加载统一改成GamePanel.class.getResource(/res/bg.png)然后在 IDEA 里右键 res 目录Mark Directory as → Resources Root。改完以后重新编译再跑九成九的 NPE 就没了。如果还不放心可以在加载方法里先打印 url 看有没有拿到非 null 值。5.2 画面闪烁把定时任务和重绘搅在一起现象游戏能玩但画面疯狂闪烁尤其管道移动的时候像在跳帧。原因闪烁的本质是同一帧画面被重复绘制或者绘制时机不对。最常见的情况是作者用了 java.util.Timer 或 new Thread在子线程里 Thread.sleep(16) 然后调 repaint()这会让重绘请求在两个线程之间乱跳Swing 的双缓冲机制在这种情况下形同虚设。解决主循环换成 javax.swing.Timer让回调稳定地在 EDT 上执行。另一个常见元凶是 JPanel 没有开启双缓冲。JPanel 默认是双缓冲的但你如果在构造方法里调用过 setDoubleBuffered(false) 或把它塞进了 Canvas 组合就要检查一下。一般情况下「Swing Timer JPanel 默认双缓冲」就是最稳的组合。5.3 键盘没反应焦点根本不在画布上现象启动后画面正常按空格完全没有反应用鼠标点一下窗口画面才恢复响应。原因JPanel 默认不可聚焦键盘事件只会派发给当前拥有焦点的组件。窗口刚启动时焦点在 JFrame 上KeyListener 却加在 JPanel 上事件根本没到它手里。解决在 GamePanel 构造方法加setFocusable(true)在 GameFrame 的窗口显示事件里调gamePanel.requestFocusInWindow()。这样窗口一弹出焦点就在画布上。还有个附带问题按键用 keyPressed 而不是 keyReleased 判断时长按空格会触发系统键盘自动重复小鸟连续扑腾操作会变得不可控。习惯上我会在 keyPressed 里加一个 300 毫秒的去抖标记或者改用 keyReleased 触发跳跃。5.4 游戏速度忽快忽慢循环节奏没对齐现象管道移动速度时快时慢有时一场游戏玩到一半突然加速。原因用 Thread.sleep 控制帧率时sleep 只保证「最少等待」不保证精确周期加上 GC、窗口拖动带来的绘制开销每一帧实际时间间隔是乱的。还有一种可能是代码里用了 System.currentTimeMillis() 计算时间差但没在游戏开始前初始化上一次时间戳导致第一帧 delta 异常大。解决最省心的方案还是固定周期 Swing Timer。如果你确实想要更精确的帧间间隔可以用「记录上次更新时间 累加 delta」的方式但注意要对 delta 做上限钳制防止窗口最小化后恢复时一帧追回几秒的差距。下面是一段常用模板long lastTime System.nanoTime(); double accumulator 0; while (running) { long now System.nanoTime(); accumulator (now - lastTime) / 1_000_000_000.0; lastTime now; accumulator Math.min(accumulator, 0.05); // 防止卡顿后追帧 while (accumulator 0.016) { tick(); accumulator - 0.016; } }这段的 0.016 就是 60 fps 的帧周期秒数。累加器的意义是把物理更新和渲染帧率解耦积累够一个帧周期就更新一次。0.05 的上限是必须的否则电脑卡了 3 秒恢复后会瞬间模拟上百帧小鸟直接穿到地图外面。5.5 碰撞判定太严原图矩形直接判断的后果现象小鸟看起来只擦到管道边缘一两个像素甚至完全没碰到却判定死亡。原因图片加载后是矩形 Bitmap小鸟素材四周通常有透明像素直接用整个图片尺寸建 Rectangle碰撞盒会比实际小鸟大一圈视觉上自然产生「空气墙」。解决把 Bird 的碰撞盒改成内缩矩形。一般做法是让碰撞盒宽度和高度都是图片边长的一半左右然后以小鸟中心为基准计算public Rectangle getCollisionBox() { // 60x60 的图片碰撞盒用 30x30留出透明边 int half 30 / 2; return new Rectangle((int) x - half, (int) y - half, 30, 30); }这里 30 不是随便选的数字它是「视觉边界」和「操作难度」的平衡点。太小会让玩家觉得游走在作弊边缘太大就是空气墙。调试这个值有个土办法把碰撞盒用半透明颜色画出来跑几局看盒子和图片边缘差多少这在第 6 章会给出具体代码。另外前面提过的已通过管道二次检测也在碰撞逻辑里一并检查一下确认每根管道只判定一次。6. 验证与扩展把碰撞盒画出来再给它加点难度曲线游戏做完不是终点你怎么证明它「做对了」才是代码能力的分水岭。这一章给两个实用技巧一个是把碰撞盒可视化用来验证手感时判断碰撞判定是否符合直觉另一个是给游戏加难度曲线让分数和管道速度联动这是把它从「课程设计 Demo」升级到「可玩作品」的第一步。6.1 可视化碰撞盒三行代码看清死因在 GamePanel 的 paintComponent 里绘制完所有素材后用半透明红色把 birdBox 画出来g2.setColor(new Color(255, 0, 0, 100)); // 最后一位是透明度 g2.fill(birdBox); // birdBox 就是碰撞检测用的 Rectangle跑起来以后小鸟核心区域会被一个半透明红块标出来。你一眼就能看出两件事一是红块是否和图片边缘对齐如果偏大就把内缩系数调小二是死之前红块到底和管道重叠了多少能直接验证「是不是空气墙」。调试完记得加一个开关控制这段绘制比如静态 boolean DEBUGtrue平时关闭需要排查时打开。6.2 难度曲线分数驱动管道加速静态难度的游戏玩三局就没意思了。一个最简单的动态难度方案是每得 10 分管道速度增加 0.3间隙缩小 2 像素。实现时把 Pipe.SPEED 改成实例变量而不是静态常量public void onScoreChanged(int score) { // 每 10 分加速一次速度上限设为 4防止后期变成弹幕游戏 if (score % 10 0) { speed Math.min(2 score / 10 * 0.3, 4); } }调用时机放在加分逻辑里也就是检测到小鸟通过管道成功得分的那一刻。注意处理一个边界如果分数从 19 跳到 20mod 10 为 0 才触发加速这个判断没加的话每过一根管道都在加速后段基本没法玩。难度曲线的调法也没有标准答案我的习惯是把「通关率」控制在 30%40%这个数值是一个可玩性比较常见的区间。讲到这里这份 Java 版飞翔的小鸟的完整脉络就清晰了。说句实在话我每次拆别人小游戏代码第一件事从来不是跑起来而是先把入口类和主循环找出来确定它是 Swing Timer 还是线程 sleep然后才敢碰后面那些类。这两个点不确认后面所有调试都会踩在第 5 章那几个坑上。从那以后我拿到任何人的 Java 小游戏代码都是先画碰撞盒、再调两个手感参数最后才谈扩展功能顺序错了永远不知道一个 Demo 到底死于哪一帧。如果要用它来准备 Java 面试鸟类拆类、管道容器管理、Timer 线程模型都是现成的聊资。希望帮到你。本文还有配套的精品资源点击获取
Java版飞翔的小鸟完整代码解析：Swing游戏开发实战与避坑指南
简介在Java图形界面开发领域Swing是构建桌面小游戏最经典的框架之一。游戏循环的稳定性、物理模拟的真实性以及碰撞检测的精准度共同决定了一款休闲游戏的体验质量。通过剖析基于Swing Timer的定时刷新机制、重力加速度与跳跃初速度的数值模型、矩形相交判定算法可以系统掌握Java游戏开发的底层逻辑。这类知识不仅适用于飞行躲避类游戏也能迁移到其他2D小游戏的工程实践中。本文从工程结构、资源加载、主循环设计、碰撞优化到手感调参完整拆解一个可运行的飞翔的小鸟JAVA版游戏案例帮助初学者避开图片路径失效、画面闪烁、键盘焦点丢失等典型陷阱并给出难度曲线的扩展思路。1. 飞翔的小鸟 Java 版一份能跑的完整代码到底包含什么从搜索框敲下「java 飞翔的小鸟 游戏 编程」的人一半是课程设计要交 Demo 的学生一半是刚啃完 Java 基础想找个完整案例练手的新手。这两类人最常见的翻车现场一模一样资源下载后一运行图片路径报 NPE、中文乱码、键盘没反应只能对着报错干瞪眼。这份飞翔的小鸟代码完整版java 版的价值不在于画面多精致而是把 Swing 小游戏必需的骨架凑齐了——游戏循环、重力模拟、随机管道、碰撞检测、计分与状态切换。它纯 JDK 自带库实现不用 Maven 拉依赖、不用配特殊环境解压就能跑。学生党拿它当课程设计骨架改改界面交作业初学者把它当源码教材每读一个类事件监听和面向对象这两块就算真落地了。2. 运行环境与工程结构JDK 怎么选、资源文件放哪这类 Swing 小游戏对 JDK 版本非常不敏感但「能用」和「省心」是两码事。我先说结论首选 JDK 8。原因有两个一是绝大多数课程设计和老教材都以 JDK 8 为目标环境很多网传代码根本没按模块系统拆分JDK 9 以后直接用 javac 编译会出现模块访问报错二是 JDK 8 的 javax.swing 不需要额外配置而 JDK 9 如果按模块化方式管理工程还得在 module-info.java 里补 requires java.desktop 这类声明。如果你机器上已经装了 JDK 17 也没关系普通 classpath 工程照样能跑但与其排查模块问题不如直接装一个 JDK 8 来得稳。至于下载渠道去 java 官网 jdk 下载页面选一个 8u 的 Windows/Linux 安装包就行。IDE 我一般推荐 IntelliJ IDEA Community 版Eclipse 的工作空间概念对刚入门的人是个不必要的负担。用 IDEA 打开代码包时只需要把它当成普通 Java 工程导入不要选 Maven/Gradle 模板因为这份代码根本不需要那套依赖管理。这里顺带说一句凡是需要你配一堆 plugin 和 dependency 才跑得起来的小游戏本身就是工程化过度纯 Swing 代码正确的打开方式就是「一个 JDK、一个 IDE、一个入口类」。2.1 JDK 版本与 IDE 选型JDK 版本的坑值得再展开一点。很多人用 JDK 17 跑 8 写的代码遇到 javax.swing 相关编译错误第一反应是代码有问题其实多半是模块化的问题。下面这个表格是我实际遇到的几种情况场景JDK 8JDK 11建议javac 直接编译无模块限制直接过报 package javax.swing is not visible加 --add-modules java.desktop 或换 8IDEA 普通工程无感知无感知两者都行打包成可执行 jar正常需在 MANIFEST 处理优先 8其实就算报错也有后悔药在 javac 后面加一句 --add-modules java.desktop 就能编过或者在 IDEA 里把 Module 的依赖加上 java.desktop。但是这门课如果老师要求的就是 JDK 8 环境你没必要给自己找事直接统一版本最省事。判断代码包到底是哪个 JDK 写的有个土办法看代码里有没有用 var 关键字或者 record 这类明显的新语法有就是 11没有就默认 8 处理。2.2 工程目录与入口类职责下载解压后先别急着点运行花两分钟把目录结构认一遍。这类 Swing 小游戏普遍是单线程多类设计典型的目录长这样flappy-bird/ ├── src/ │ ├── GameFrame.java # 入口创建窗口并启动游戏 │ ├── GamePanel.java # 画布主循环、绘制、碰撞检测 │ ├── Bird.java # 小鸟实体坐标、速度、跳跃逻辑 │ ├── Pipe.java # 管道实体位置、间隙、移动逻辑 │ └── res/ │ ├── bg.png # 背景图 │ ├── bird.png # 小鸟图 │ └── pipe.png # 管道图 └── out/ # 编译输出目录首次编译后生成这份结构里最容易被新手忽略的是 res 目录。它必须放在 src 根下而不是和 src 平级也不是随便放哪都行因为后面代码里加载资源走的是 classpath而 src 根目录在编译后会变成 classpath 根目录。资源放在 src/res 下就意味着 classpath 根目录下会有一个 res 文件夹getResource(/res/bg.png) 才能找到。入口类的职责也要说清楚main 方法放在 GameFrame 里只做三件事——创建 JFrame、把 GamePanel 塞进去、调用 start() 启动主循环。凡是看到 main 方法里又写窗口又写游戏逻辑又写图片加载的代码读起来会很痛苦你接手后第一件事就是把它拆开。完整版代码如果作者没拆你自己按这个结构拆一遍也是一个非常好的重构练习。2.3 素材不走相对路径图片资源的三条放置规则接下来是资源加载这是 Swing 小游戏里最常见的翻车点。很多初版代码喜欢写ImageIO.read(new File(src/res/bg.png))这种写法在 IDE 里碰巧能跑但只要你把工程打包成 jar 分给别人立刻找不到文件。正确姿势是走 classpath// 错误示例用文件系统相对路径打包即失效 // Image bg ImageIO.read(new File(src/res/bg.png)); // 正确写法一getResource 返回 URL适合图片这类资源 Image bg ImageIO.read(GamePanel.class.getResource(/res/bg.png)); // 正确写法二getResourceAsStream 返回流适合配置文件或网络环境 // Image bg ImageIO.read(GamePanel.class.getResourceAsStream(/res/bg.png));重点解释两个细节。第一是路径前那个反斜杠不是随手的它表示从 classpath 根目录开始找没有它就是在当前类所在包下找包名一复杂就出错。第二是 getResource 返回 URL如果资源不存在会返回 nullImageIO.read(null) 不会给你一个亲切的「文件不存在」提示而是直接抛 NPE所以很多人看到 NPE 以为是小鸟对象没初始化其实是图片没加载到。习惯上我会把资源加载写成一个静态方法统一处理 null 和抛异常public static Image loadImage(String path) throws IOException { URL url GamePanel.class.getResource(path); if (url null) { throw new IOException(资源不存在: path); } return ImageIO.read(url); }这层包装有两个好处。一是报错信息可读资源路径写错了能立刻看出来是哪个文件的问题二是后续代码里所有图片加载都走这一个入口不会出现一个类用 File、一个类用 getResource 的混乱局面。你拿到完整版代码后如果发现里面有用到 ImageIO.read 的地方建议全部统一成这种写法能省掉后面反复排查资源问题的力气。3. 核心代码拆解游戏循环、重力模型与碰撞判定的实现这一章是整份代码最值钱的部分。很多所谓「完整版」代码功能是能跑但读起来一团乱麻——一个类里又画背景又管碰撞又算分数你根本没法改。合格的做法是把每一块职责拆开然后用一条主循环把它们串起来。下面我按「循环怎么转、小鸟怎么跳、管道怎么来、碰撞怎么判」四个问题来讲你拿着完整代码对照着看很快就能定位到对应的方法。3.1 游戏主循环Swing Timer 为什么比线程 sleep 稳小游戏和普通业务系统最大的区别就是有一个「每帧都在转」的主循环。Java 里做循环有三种常见方案但适合 Swing 的只有一个用 javax.swing.Timer。public class GamePanel extends JPanel { private static final int FRAME_INTERVAL 16; // 毫秒约 60 FPS private Bird bird; private ListPipe pipes; private Timer timer; public GamePanel() { bird new Bird(100, 300); pipes new LinkedList(); // Timer 的回调在 EDT 线程执行能安全操作 Swing 组件 timer new Timer(FRAME_INTERVAL, e - { bird.update(); for (Pipe pipe : pipes) { pipe.move(); } checkCollision(); repaint(); // 请求重绘paintComponent 会被调用 }); } public void start() { timer.start(); } }这段代码逻辑不复杂但有一个知识点值得停下来想清楚为什么不能用while (true) { ... Thread.sleep(16); repaint(); }因为 Swing 的组件有一套自己的线程模型所有 UI 更新必须在事件分发线程EDT上执行。你在普通子线程里调用 repaint()轻则画面不刷新重则界面卡死这是 Swing 开发的铁律。Timer 的设计目标就是解决这个问题它的回调天然跑在 EDT 上所以在回调里改 bird、改 pipes、调 repaint 都是安全的。FRAME_INTERVAL 参数是控制帧率的关键把 16 改成 25 就是 40 FPS改成 33 就是 30 FPS。帧率低的小游戏画面会肉眼可见地一顿一顿所以一般不要低于 30。这里还要提一句如果你看到代码里用的是 java.util.Timer 或 new Thread sleep那这个版本大概率会有闪烁或者卡顿问题参照这一节改成 Swing Timer 就行。3.2 重力与跳跃两个参数决定一套手感小鸟的飞行手感本质是两个数字的组合重力和跳跃初速度。这是物理模拟里最简化的版本不考虑加速度曲线只用匀变速直线运动对初学者来说完全够用。public class Bird { private double x, y; // 坐标 private double velocity; // 垂直速度单位像素/帧 private final double gravity 0.3; // 重力加速度每帧速度增加量 private final int radius 15; // 绘制半径供 paintComponent 使用 public Bird(int x, int y) { this.x x; this.y y; } // 玩家按空格触发一次扇翅 public void flap() { velocity -6.5; // 负值表示向上绝对值决定跳跃力度 } // 每一帧都调用 public void update() { velocity gravity; // 速度逐帧增加模拟重力加速 y velocity; // 速度叠加到坐标上 } }理解这段代码有一个先后顺序要绕明白先改速度再改坐标。flap() 直接把速度设成 -6.5相当于给小鸟一个瞬间向上的冲量之后每一帧 update() 先让速度朝正方向向下增加 0.3再把速度叠到 y 坐标上。所以小鸟的轨迹是「快速上升 → 到达顶点 → 加速下落」整体是一条抛物线。想调整手感只需要改两个数字gravity 越大小鸟坠得越快操作越急躁flap 的绝对值越大每次跳跃抬升越高。我自己调试的时候习惯把 gravity 调到 0.25、flap 调到 -7这样跳跃更有韧性一点接近原版 Flappy Bird 的节奏。如果你的画布是 600 像素高gravity 0.3 搭配 flap -6.5 大约能让小鸟跳起 70 像素这个幅度在管道间隙 140 像素的场景下刚好能过关数值选得太大反而让游戏变得太简单。3.3 管道生成与移动链表容器与随机间隙管道和背景不一样它需要无限生成但又不能无限创建对象否则内存和 GC 都会横插一脚。常见做法是用一个链表装所有「活着」的管道不停地从右侧生成、左侧移除。这正好是一个 Java 容器使用的标准场景。public class Pipe { public static final int WIDTH 60; // 管道宽度 public static final int GAP_HEIGHT 140; // 上下管道之间的间隙 private static final int SPEED 2; // 每帧左移像素 private int x; // 管道左侧 x 坐标 private int gapCenter; // 间隙中心的 y 坐标 public Pipe(int startX, int gapCenter) { this.x startX; this.gapCenter gapCenter; } public void move() { x - SPEED; } public boolean isOffScreen() { return x WIDTH 0; // 完全移出屏幕左侧说明可以回收 } public int getGapTop() { return gapCenter - GAP_HEIGHT / 2; } public int getGapBottom() { return gapCenter GAP_HEIGHT / 2; } }gapCenter 的随机生成范围直接决定游戏难度。如果画布高度是 600背景地面大约在 520 的位置那么 gapCenter 在 180 到 380 之间随机比较合理——太靠上小鸟容易撞地太靠下小鸟要飞很高才够得着。生成和管理这些管道我一般会在 GamePanel 里维护一个 LinkedList 每帧移动管道并检查状态private void spawnAndRecyclePipes() { // 只有当最新一根管道已经走到画布中央偏右时才生成下一根 if (pipes.isEmpty() || pipes.getLast().getX() getWidth() - 260) { pipes.add(new Pipe(getWidth(), 180 new Random().nextInt(200))); } // 移除已经离开屏幕的管道 pipes.removeIf(pipe - pipe.isOffScreen()); }这里有两个参数值得记一下。260 是相邻管道的水平间距间距太小会导致连续两个间隙叠在一起玩家根本没有反应时间间距太大游戏会显得空旷。180 nextInt(200) 是随机范围也就是 gapCenter 在 180380 之间波动你也可以根据自己对难度预期改成 150 nextInt(260) 之类。removeIf 这一步看着简单少了它管道 List 会无限膨胀几十分钟后游戏就会明显变卡。3.4 碰撞检测矩形相交与上下边界碰撞检测的实现可以直接决定玩家对游戏的评价——明明没撞上却死了比难还让人恼火。Swing 提供的 Rectangle 类自带 intersects 方法所以绝大多数实现都把它拆成两个矩形来碰撞。private void checkCollision() { Rectangle birdBox bird.getCollisionBox(); // 内缩后的碰撞盒 for (Pipe pipe : pipes) { // 上管道从画布顶部到间隙上沿 Rectangle upperBox new Rectangle(pipe.getX(), 0, Pipe.WIDTH, pipe.getGapTop()); // 下管道从间隙下沿到画布底部 Rectangle lowerBox new Rectangle(pipe.getX(), pipe.getGapBottom(), Pipe.WIDTH, getHeight() - pipe.getGapBottom()); if (birdBox.intersects(upperBox) || birdBox.intersects(lowerBox)) { gameOver(); return; } } // 上下边界飞出屏幕也算失败 if (bird.getY() 0 || bird.getY() GROUND_Y) { gameOver(); } }碰撞判定分三层每一层都有讲究。第一层是拆成上下两个矩形上管道从 y0 到间隙上沿下管道从间隙下沿到画布底这样用一个循环就能同时检测两根管子。第二层是 birdBox 必须用内缩后的碰撞盒这一点放到第 5 章避坑里详细说这里先记住结论图片 60x60碰撞盒用 30x30 的矩形才接近真实边界。第三层是上下边界用坐标直接判断而不是再建矩形因为撞到天花板不一定要碰撞盒y 0 就足够准确。这里还要提醒一个隐藏 bug管道通过小鸟之后如果不加标记检查循环里依然会检测这根管道但此时小鸟已经飞到管道左边矩形不重叠不影响游戏。真正的隐患是加分逻辑——如果写的是「每根管道经过一次加分」没有标记的话重复判断会导致分数一次加多次。完整代码里一般会写一个 hasPassed 字段你在读代码的时候可以重点找一下。4. 把代码跑起来导入、编译、操作与三处手感调参前面把代码结构讲完了这一章解决「怎么让它真的跑起来」。老实说一个纯 Swing 的 Java 小游戏运行方式简单到没有悬念要么 IDE 里点运行按钮要么命令行 javac/java 两连。下面把两种方式都写一遍再附上操作逻辑和我常用的三处调参位置。4.1 命令行编译与运行先给不喜欢开 IDE 或者想在 Linux 服务器上验证的同学。假设你已经把代码解压到 flappy-bird 目录并且 JDK 8 已经加到 PATH 里那么cd flappy-bird # 编译所有源码到 out 目录-encoding 防止 Windows 下中文注释乱码 javac -encoding UTF-8 -d out src/*.java # 运行入口类-cp 指定 classpath 根目录为 out java -cp out GameFrame这里的 -encoding UTF-8 是我特别叮嘱的。Windows 控制台默认编码是 GBK或者新系统里的代码页 936如果源码文件本身是 UTF-8 保存的不加这个参数注释和字符串里的中文就会变成乱码严重的时候直接编译报错「非法字符」。加了之后编译阶段不再有编码问题。另外注意 javac 和 java 是连着两步很多人只编译不运行或者编译完忘了 -cp out结果报「找不到或无法加载主类 GameFrame」这一类问题第 5 章再系统讲。还有个常见变体是代码包里直接带了 run.bat 这种启动脚本。脚本意思是一样的但内容多半写的是java -jar flappy-bird.jar或者java -cp src GameFrame。前者需要先把资源打包进 jar后者 classpath 指向 src 会让 IDE 工程和命令行混在一起新手直接双击大概率起不来。我拿到这类脚本的习惯是先看懂里面两个路径参数改成java -cp out GameFrame再执行。4.2 IDEA 导入与启动用 IDEA 打开这个工程也有一个容易忽略的细节导入的时候不要选 Maven 或 Gradle 模板。步骤是 File → New → Project from Existing Sources → 选中解压目录 → 保持默认 Create project from existing sources → 下一步时把 JDK 选成 8 → 完成。IDEA 会自己识别 src 目录为源码根目录res 目录如果没自动识别为资源根目录你需要右键 res 目录 → Mark Directory as → Resources Root。代码在不同 JDK 之间切换也有讲究。如果导入后右下角提示 JDK 版本不对就到 Project Structure → Project 里把 SDK 切到 8Modules 页签里同样确认一下 Language level 选 8。做完这两步一般就不会出现「代码里用了 List.of 之类新 API编译却报错」的尴尬。启动时直接选中 GameFrame点旁边的绿色运行按钮即可。4.3 操作逻辑与游戏状态切换跑起来以后交互逻辑非常简单按空格起跳。但这份代码里的游戏状态切换值得单独讲因为它在几乎所有同类小游戏中都是模板级的存在。public enum GameState { READY, RUNNING, OVER } private void handleKeyPress(KeyEvent e) { if (e.getKeyCode() ! KeyEvent.VK_SPACE) { return; } switch (state) { case READY: case OVER: resetGame(); // 重置小鸟位置、清空管道、分数归零 state GameState.RUNNING; timer.start(); break; case RUNNING: bird.flap(); break; } }三个状态把游戏生命周期分得很干净READY 是启动等待画面此时按空格开始RUNNING 是正常游戏空格触发跳跃OVER 是碰撞后的结束画面再按空格则是重开。用枚举而不是 int 常量来表示状态在业务代码里也是好习惯它的好处是编译器会帮你检查不会出现 state 2 这种魔法数字没人读得懂的问题。值得注意的是 READY 和 OVER 两个状态共用了一段重置逻辑这是刻意的。死完直接重开不需要玩家再点一次鼠标或回车符合这类小游戏的交互习惯。如果你想把「死后必须再等一秒才能重开」加进去可以在 OVER 状态里加一个时间戳判断简单但有效。4.4 手感调参gravity、flap 和 gapHeight游戏能跑只是第一步手感才是决定它是否「好玩」的关键。这份完整版代码里的几个参数分别控制坠落速度、跳跃高度和通过难度对应关系如下参数位置常见值调整方向与影响gravityBird 类字段0.3越大坠落越快操作需要更频繁flap 初速度Bird.flap() 中-6.5绝对值越大跳得越高pipeSpeedPipe 类常量2越大整体游戏节奏越快gapHeightPipe 类常量140越小越难钻越大越简单调参最忌讳一次性乱改。我的做法是每次只改一个参数跑三局感受差别后再动下一个。先调 flap 初速度让自己觉得「跳得起来」再调 gravity 找到「坠落不飘不坠」的中间值最后调 gapHeight 和管道速度控制难度。如果改了 Bird 里的参数发现没有生效先检查是不是有多个 Bird 类文件——有些版本会把旧类留在同包下面IDE 编译时用了旧的。这一章说完整理完其实还缺一个验证手感的自动化手段放到最后一章专门讲这里先不展开。5. 避坑指南启动失败、画面闪烁、按键不灵的五个常见问题运行这一类 Swing 小游戏 Demo新手踩坑的概率比想象中高很多而且坑位非常集中。这一章把我拆过多个 Java 小游戏代码后最常遇到的五个问题按「现象 → 原因 → 解决」写出来每条都可以直接对照着排查。5.1 图片加载失败报错 NPE 的根源是资源路径现象窗口能弹出来背景和小鸟全部是空白控制台抛 NullPointerException定位到 ImageIO.read 那行。原因图片路径写错或资源目录没被识别。多数初版代码用的是new File(src/res/bg.png)这种相对路径它依赖「当前工作目录」恰好是工程根目录只要启动方式一变比如从命令行 java -cp out 启动路径立刻失效。还有一种情况是 IDEA 里 res 目录没有被标成 Resources Root编译后 classpath 里根本没有 res 文件夹。解决把资源加载统一改成GamePanel.class.getResource(/res/bg.png)然后在 IDEA 里右键 res 目录Mark Directory as → Resources Root。改完以后重新编译再跑九成九的 NPE 就没了。如果还不放心可以在加载方法里先打印 url 看有没有拿到非 null 值。5.2 画面闪烁把定时任务和重绘搅在一起现象游戏能玩但画面疯狂闪烁尤其管道移动的时候像在跳帧。原因闪烁的本质是同一帧画面被重复绘制或者绘制时机不对。最常见的情况是作者用了 java.util.Timer 或 new Thread在子线程里 Thread.sleep(16) 然后调 repaint()这会让重绘请求在两个线程之间乱跳Swing 的双缓冲机制在这种情况下形同虚设。解决主循环换成 javax.swing.Timer让回调稳定地在 EDT 上执行。另一个常见元凶是 JPanel 没有开启双缓冲。JPanel 默认是双缓冲的但你如果在构造方法里调用过 setDoubleBuffered(false) 或把它塞进了 Canvas 组合就要检查一下。一般情况下「Swing Timer JPanel 默认双缓冲」就是最稳的组合。5.3 键盘没反应焦点根本不在画布上现象启动后画面正常按空格完全没有反应用鼠标点一下窗口画面才恢复响应。原因JPanel 默认不可聚焦键盘事件只会派发给当前拥有焦点的组件。窗口刚启动时焦点在 JFrame 上KeyListener 却加在 JPanel 上事件根本没到它手里。解决在 GamePanel 构造方法加setFocusable(true)在 GameFrame 的窗口显示事件里调gamePanel.requestFocusInWindow()。这样窗口一弹出焦点就在画布上。还有个附带问题按键用 keyPressed 而不是 keyReleased 判断时长按空格会触发系统键盘自动重复小鸟连续扑腾操作会变得不可控。习惯上我会在 keyPressed 里加一个 300 毫秒的去抖标记或者改用 keyReleased 触发跳跃。5.4 游戏速度忽快忽慢循环节奏没对齐现象管道移动速度时快时慢有时一场游戏玩到一半突然加速。原因用 Thread.sleep 控制帧率时sleep 只保证「最少等待」不保证精确周期加上 GC、窗口拖动带来的绘制开销每一帧实际时间间隔是乱的。还有一种可能是代码里用了 System.currentTimeMillis() 计算时间差但没在游戏开始前初始化上一次时间戳导致第一帧 delta 异常大。解决最省心的方案还是固定周期 Swing Timer。如果你确实想要更精确的帧间间隔可以用「记录上次更新时间 累加 delta」的方式但注意要对 delta 做上限钳制防止窗口最小化后恢复时一帧追回几秒的差距。下面是一段常用模板long lastTime System.nanoTime(); double accumulator 0; while (running) { long now System.nanoTime(); accumulator (now - lastTime) / 1_000_000_000.0; lastTime now; accumulator Math.min(accumulator, 0.05); // 防止卡顿后追帧 while (accumulator 0.016) { tick(); accumulator - 0.016; } }这段的 0.016 就是 60 fps 的帧周期秒数。累加器的意义是把物理更新和渲染帧率解耦积累够一个帧周期就更新一次。0.05 的上限是必须的否则电脑卡了 3 秒恢复后会瞬间模拟上百帧小鸟直接穿到地图外面。5.5 碰撞判定太严原图矩形直接判断的后果现象小鸟看起来只擦到管道边缘一两个像素甚至完全没碰到却判定死亡。原因图片加载后是矩形 Bitmap小鸟素材四周通常有透明像素直接用整个图片尺寸建 Rectangle碰撞盒会比实际小鸟大一圈视觉上自然产生「空气墙」。解决把 Bird 的碰撞盒改成内缩矩形。一般做法是让碰撞盒宽度和高度都是图片边长的一半左右然后以小鸟中心为基准计算public Rectangle getCollisionBox() { // 60x60 的图片碰撞盒用 30x30留出透明边 int half 30 / 2; return new Rectangle((int) x - half, (int) y - half, 30, 30); }这里 30 不是随便选的数字它是「视觉边界」和「操作难度」的平衡点。太小会让玩家觉得游走在作弊边缘太大就是空气墙。调试这个值有个土办法把碰撞盒用半透明颜色画出来跑几局看盒子和图片边缘差多少这在第 6 章会给出具体代码。另外前面提过的已通过管道二次检测也在碰撞逻辑里一并检查一下确认每根管道只判定一次。6. 验证与扩展把碰撞盒画出来再给它加点难度曲线游戏做完不是终点你怎么证明它「做对了」才是代码能力的分水岭。这一章给两个实用技巧一个是把碰撞盒可视化用来验证手感时判断碰撞判定是否符合直觉另一个是给游戏加难度曲线让分数和管道速度联动这是把它从「课程设计 Demo」升级到「可玩作品」的第一步。6.1 可视化碰撞盒三行代码看清死因在 GamePanel 的 paintComponent 里绘制完所有素材后用半透明红色把 birdBox 画出来g2.setColor(new Color(255, 0, 0, 100)); // 最后一位是透明度 g2.fill(birdBox); // birdBox 就是碰撞检测用的 Rectangle跑起来以后小鸟核心区域会被一个半透明红块标出来。你一眼就能看出两件事一是红块是否和图片边缘对齐如果偏大就把内缩系数调小二是死之前红块到底和管道重叠了多少能直接验证「是不是空气墙」。调试完记得加一个开关控制这段绘制比如静态 boolean DEBUGtrue平时关闭需要排查时打开。6.2 难度曲线分数驱动管道加速静态难度的游戏玩三局就没意思了。一个最简单的动态难度方案是每得 10 分管道速度增加 0.3间隙缩小 2 像素。实现时把 Pipe.SPEED 改成实例变量而不是静态常量public void onScoreChanged(int score) { // 每 10 分加速一次速度上限设为 4防止后期变成弹幕游戏 if (score % 10 0) { speed Math.min(2 score / 10 * 0.3, 4); } }调用时机放在加分逻辑里也就是检测到小鸟通过管道成功得分的那一刻。注意处理一个边界如果分数从 19 跳到 20mod 10 为 0 才触发加速这个判断没加的话每过一根管道都在加速后段基本没法玩。难度曲线的调法也没有标准答案我的习惯是把「通关率」控制在 30%40%这个数值是一个可玩性比较常见的区间。讲到这里这份 Java 版飞翔的小鸟的完整脉络就清晰了。说句实在话我每次拆别人小游戏代码第一件事从来不是跑起来而是先把入口类和主循环找出来确定它是 Swing Timer 还是线程 sleep然后才敢碰后面那些类。这两个点不确认后面所有调试都会踩在第 5 章那几个坑上。从那以后我拿到任何人的 Java 小游戏代码都是先画碰撞盒、再调两个手感参数最后才谈扩展功能顺序错了永远不知道一个 Demo 到底死于哪一帧。如果要用它来准备 Java 面试鸟类拆类、管道容器管理、Timer 线程模型都是现成的聊资。希望帮到你。本文还有配套的精品资源点击获取