拓冰网站定制 
简介这是一份面向Java初学者与游戏开发入门者的完整版《飞翔的小鸟》桌面游戏源码项目聚焦面向对象设计、游戏逻辑实现与动态难度调控等核心编程实践。资源包含32个文件涵盖5个关键Java源文件如Bird主类、ScoreSystem计分器、PoleGenerator柱子生成器等、6个编译后class文件、18张UI资源PNG图以及Eclipse工程配置文件.project、.classpath、.prefs总大小仅139KB轻量易读结构清晰便于逐模块分析。已有2952人学习下载适合通过真实游戏案例掌握重力模拟、碰撞检测、帧率控制、状态管理及Swing/JavaFX界面集成等关键技术。代码实现了分数驱动的三阶难度机制0–14分常态、15–30分加速双倍得分、31分起极速三倍得分及星星奖励系统辅以完整的工程目录组织是理解Java游戏开发全流程的优质教学范本。1. 飞翔的小鸟 Java 完整版不是玩具 Demo而是可调试、可扩展、能跑通物理碰撞与状态机的真实游戏骨架你在网上搜“飞翔的小鸟 Java”大概率会撞上一堆只有 200 行、没音效、不处理碰撞、小鸟飞着飞着就穿墙而出的“教学示例”。但这次这个「飞翔的小鸟代码完整版Java版」不是那种——它用标准 Swing Timer 构建含完整状态机Start/Playing/GameOver、像素级碰撞检测非矩形粗略判断、动态生成且带间距校验的管道Pipe系统、计分逻辑、重试机制甚至预留了 ScoreBoard 和 SoundManager 接口。它不依赖任何第三方游戏引擎纯 JDK 8 即可编译运行源码结构清晰Bird.java封装角色行为Pipe.java管理障碍物生命周期GamePanel.java是主渲染与逻辑调度中心。适合 Java 初学者练手 Swing 事件驱动和绘图更适合正在准备蓝桥杯算法题或 Java 工程师面试的同学——因为里面藏着真实项目里才会写的边界处理比如bird.getY() 0时强制设为 0 而非任其负值溢出、pipe.getX() -pipe.getWidth()才真正移除而非简单removeAll()、帧率控制用System.nanoTime()而非Thread.sleep()这种玄学延迟。如果你正卡在“写了半天动画不动”“跳起来穿墙”“分数不更新”这些血泪问题上这份代码就是你该立刻下载、逐行打断点调试的那一个。2. 从零跑通JDK 环境、工程结构与核心类职责拆解2.1 环境要求与最小可运行验证本项目严格限定在JDK 8u202 或更高版本JDK 11 亦完全兼容无需 Maven 或 Gradle——它就是一个标准 Java SE 桌面应用。你不需要安装任何 IDE 插件也不需要配置 Tomcat 或 Spring Boot。只需确认终端能执行java -version输出应类似java version 1.8.0_361 Java(TM) SE Runtime Environment (build 1.8.0_361-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.361-b09, mixed mode)提示若提示command not found: java请先完成 Java 环境变量配置JAVA_HOME指向 JDK 根目录PATH包含$JAVA_HOME/bin。这不是本项目的锅但它是你跑通的第一道门槛——别跳过别幻想“IDE 自带 JRE 就够了”Swing 程序对 AWT Toolkit 初始化极其敏感必须用系统级java命令启动。验证环境后进入项目根目录即含src/文件夹的目录执行编译命令javac -d bin -sourcepath src src/com/example/flappybird/Main.java注意参数含义-d bin指定 class 文件输出到bin/目录项目自带该空文件夹-sourcepath src告诉编译器源码在src/下支持包路径解析如com.example.flappybirdsrc/com/example/flappybird/Main.java入口类全限定名路径不可写成Main.java或com.example...——这是 Java 编译器硬性要求编译成功后执行java -cp bin com.example.flappybird.Main-cp bin表示类路径为bin/确保加载的是刚编译出的.class文件而非旧缓存。此时窗口弹出小鸟静止在左侧按空格键开始游戏——这才是真正的“最小可运行”。2.2 工程结构与四大核心类职责项目采用经典 MVC 分离思想虽未严格分层但职责清晰目录/文件职责说明关键技术点src/com/example/flappybird/Main.java程序入口创建 JFrame 并初始化 GamePanelSwing 线程安全SwingUtilities.invokeLater(...)包裹 GUI 创建src/com/example/flappybird/GamePanel.java主游戏画布继承JPanel重写paintComponent()实现双缓冲绘图内含Timer控制游戏循环60 FPS使用BufferedImageGraphics2D实现抗锯齿绘制Timer的actionPerformed()中调用update()和repaint()避免直接在 paint 中修改状态src/com/example/flappybird/Bird.java小鸟实体类封装位置 (x,y)、速度 (vy)、加速度 (gravity)、旋转角度模拟俯仰、生命状态物理模拟vy gravity→y vy角度计算基于vyrotation Math.toDegrees(Math.atan2(vy, 1)) * 0.2平滑过渡src/com/example/flappybird/Pipe.java管道类含上下两段Rectangle用于碰撞检测、X 坐标、是否已计分标记碰撞判定bird.getBounds().intersects(pipe.getTopRect())特别注意GamePanel中的update()方法——它才是游戏逻辑的真正心脏。这里不做绘图只做三件事更新小鸟vy和y重力跳跃遍历所有Pipe更新其x坐标向左移动检查是否越界销毁检查是否与小鸟碰撞检查是否触发计分小鸟 X 超过管道中心线且未标记已计分这种“逻辑更新与画面渲染分离”的设计是 Swing 游戏避免闪烁和逻辑错乱的基石。很多初学者把y vy写在paintComponent()里结果一卡顿就飞穿墙——因为绘图频率不稳定而物理更新必须恒定。2.3 启动流程与 Swing EDT 线程安全实践Java Swing 组件必须在Event Dispatch Thread (EDT)上创建和修改。Main.java中的启动代码是教科书级范式public static void main(String[] args) { SwingUtilities.invokeLater(() - { JFrame frame new JFrame(飞翔的小鸟); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setResizable(false); GamePanel gamePanel new GamePanel(); frame.add(gamePanel); frame.pack(); // 自动计算窗口大小适配 GamePanel 的 preferredSize frame.setLocationRelativeTo(null); // 居中显示 frame.setVisible(true); }); }关键点解析SwingUtilities.invokeLater(...)将 GUI 创建任务提交到 EDT 队列确保线程安全。若直接在main线程中new JFrame()在某些 JDK 版本下会导致IllegalStateExceptionToolkit not initialized。frame.pack()比frame.setSize(800, 600)更可靠。GamePanel在getPreferredSize()中返回new Dimension(800, 600)pack()会据此设置窗口大小并自动包含边框和标题栏开销。硬编码尺寸易导致内容被裁剪。gamePanel.requestFocusInWindow()虽未在Main.java显式写出但应在GamePanel构造函数末尾添加否则键盘事件空格跳跃可能不响应——因为焦点不在面板上。这是新手高频翻车点。GamePanel的KeyListener注册也需谨慎public GamePanel() { setFocusable(true); // 必须设为 true否则无法获取焦点 requestFocusInWindow(); // 立即请求焦点 addKeyListener(new KeyAdapter() { Override public void keyPressed(KeyEvent e) { if (e.getKeyCode() KeyEvent.VK_SPACE) { if (gameState GameState.START) { gameState GameState.PLAYING; } else if (gameState GameState.PLAYING) { bird.jump(); // 调用 Bird 类的 jump() 方法 } else if (gameState GameState.GAME_OVER) { resetGame(); // 重置所有状态 } } } }); }setFocusable(true)是前提requestFocusInWindow()是保障缺一不可。很多教程漏掉这两行导致“按空格没反应”然后怀疑键盘监听逻辑——其实只是焦点没拿到。3. 物理与碰撞重力模型、跳跃响应与像素级障碍检测实现3.1 小鸟运动模型从匀速到真实抛物线的演进Bird.java的运动不是简单的y--或y -5而是基于牛顿第二定律的简化模拟public class Bird { private double x, y; private double vy; // 垂直速度单位像素/帧 private final double gravity 0.8; // 重力加速度像素/帧² private final double jumpStrength -12.0; // 跳跃初速度向上为负 public void update() { vy gravity; // 重力持续作用每帧增加向下速度 y vy; // 位置随速度变化 // 边界约束地面与天花板 if (y GamePanel.GROUND_Y - height) { y GamePanel.GROUND_Y - height; vy 0; onGround true; } if (y 0) { y 0; vy 0; } } public void jump() { if (onGround || gameState GameState.PLAYING) { vy jumpStrength; // 重置垂直速度为向上初速 onGround false; } } }这段代码实现了三个关键物理特性加速度累积vy gravity让下落越来越快形成自然抛物线而非匀速坠落。能量守恒体现jumpStrength设为-12.0负值表示向上配合gravity0.8可算出理论最大跳跃高度 ≈(12²)/(2×0.8) 90像素——这与实际视觉效果吻合证明参数可调、可预测。硬边界处理y 0时强制归零并清零vy防止小鸟从屏幕顶部消失y GROUND_Y - height时贴地且vy0避免“弹跳”假象。GROUND_Y在GamePanel中定义为HEIGHT - 100地面高度height是小鸟图片高度通常 24px所以小鸟脚部精准落在地面线上。注意vy使用double而非int是因为浮点运算能保留小数位精度。若用int vyvy 0.8会被截断为vy 0导致重力失效——这是 C/Java 混编程序员常踩的坑Java 里同样存在。3.2 管道生成与动态间距控制Pipe.java不是静态对象而是由GamePanel动态生成的集合。关键在于保证玩家有通过空间// GamePanel.java 中生成新管道的逻辑 private void spawnPipe() { int gapHeight 150; // 管道间隙固定高度像素 int minHeight 50; // 上管道最小高度 int maxHeight HEIGHT - GROUND_Y - gapHeight - minHeight; // 下管道最大高度 Random rand new Random(); int topHeight rand.nextInt(maxHeight - minHeight) minHeight; Pipe pipe new Pipe(WIDTH, topHeight, gapHeight); pipes.add(pipe); }参数解读gapHeight 150上下管道之间的空白区域这是玩家唯一可通过的区域。设得太小如 80则游戏过难太大如 250则失去挑战性。150 是经过实测的平衡值。minHeight 50上管道至少 50 像素高防止间隙顶到屏幕顶部。maxHeight计算确保topHeight gapHeight bottomHeight ≤ 可用高度其中bottomHeight HEIGHT - GROUND_Y - topHeight - gapHeight。这样无论topHeight如何随机间隙底部永远不低于地面线。Pipe构造函数中bottomY由topHeight gapHeight推导得出而非独立随机——这是保证间隙连贯性的核心。很多山寨版本让上下管道各自随机结果出现“间隙错位”上管很矮下管很高中间却没连通玩家以为是 Bug其实是逻辑缺陷。3.3 碰撞检测从 Rectangle.intersects 到像素级遮罩可选增强基础碰撞使用Rectangle// Pipe.java public Rectangle getTopRect() { return new Rectangle((int)x, 0, width, topHeight); } public Rectangle getBottomRect() { return new Rectangle((int)x, topHeight gapHeight, width, HEIGHT - topHeight - gapHeight); }Bird.java的碰撞盒是getBounds()返回的矩形基于x,y,width,height。这种 AABBAxis-Aligned Bounding Box检测高效但有误判小鸟翅膀伸出矩形外时可能“提前”撞墙。进阶做法是像素级遮罩碰撞Pixel-Perfect Collision需额外步骤加载小鸟 PNG 图片时提取 Alpha 通道透明度在Bird类中维护BufferedImage和int[] pixels数组碰撞时对两个矩形重叠区域遍历每个像素检查双方 alpha 值是否均 0示例片段需在Bird.java中添加public boolean checkPixelCollision(Pipe pipe) { Rectangle birdRect getBounds(); Rectangle pipeRect pipe.getBounds(); Rectangle overlap birdRect.intersection(pipeRect); if (overlap.isEmpty()) return false; // 获取小鸟图像在重叠区的像素坐标偏移 int birdXOffset overlap.x - (int)x; int birdYOffset overlap.y - (int)y; // 遍历重叠区每个像素 for (int dy 0; dy overlap.height; dy) { for (int dx 0; dx overlap.width; dx) { int birdPx (birdYOffset dy) * birdImage.getWidth() (birdXOffset dx); int pipePx (dy) * pipeImage.getWidth() (dx); // 简化实际需映射到 pipe 图像坐标 // 检查双方该像素是否不透明 if (birdPixels[birdPx] ! 0 pipePixels[pipePx] ! 0) { return true; // 真实像素接触 } } } return false; }注意此方案大幅提升 CPU 开销60FPS 下可能卡顿。本项目默认使用 Rectangle 检测因其在 800x600 分辨率下足够精确且性能无忧。仅当你的美术资源有大量镂空如羽毛边缘且玩家投诉“明明没碰到却死了”才值得引入像素检测——这是典型的“过度优化陷阱”新手勿盲目添加。4. 状态机与游戏循环START/PLAYING/GAME_OVER 三态流转与帧同步控制4.1 游戏状态枚举与流转条件GameState.java是一个极简但关键的枚举public enum GameState { START, // 初始界面显示标题、提示按空格 PLAYING, // 游戏进行中物理更新、碰撞检测、计分 GAME_OVER // 结束界面显示分数、提示按空格重试 }状态流转不是靠if-else堆砌而是由单一update()方法驱动// GamePanel.java public void update() { switch (gameState) { case START: // 仅等待空格键不更新小鸟/管道 break; case PLAYING: bird.update(); updatePipes(); checkCollisions(); updateScore(); break; case GAME_OVER: // 保持小鸟和管道静止只响应重试键 break; } }这种switch结构清晰隔离各状态逻辑避免“状态污染”如 GAME_OVER 时还在updatePipes()导致内存泄漏。更重要的是所有状态变更都发生在keyPressed()中而非update()内部——这是防止状态抖动的关键。例如不能在checkCollisions()里写if (collision) gameState GAME_OVER;因为一帧内可能多次调用update()导致状态反复切换。正确做法是private void checkCollisions() { for (Pipe pipe : pipes) { if (bird.getBounds().intersects(pipe.getTopRect()) || bird.getBounds().intersects(pipe.getBottomRect())) { collisionDetected true; // 标记不在这里改状态 break; } } if (collisionDetected gameState GameState.PLAYING) { gameState GameState.GAME_OVER; // 在 update() 末尾统一处理 collisionDetected false; } }4.2 游戏循环Timer 与 System.nanoTime() 的双重保障GamePanel使用javax.swing.Timer实现主循环private Timer timer; private final int TARGET_FPS 60; private final long TARGET_TIME_PER_FRAME 1000000000L / TARGET_FPS; // 纳秒 public GamePanel() { timer new Timer(1000 / TARGET_FPS, e - { update(); repaint(); }); timer.start(); }Timer的1000 / TARGET_FPS是毫秒级延迟约 16ms但 Swing Timer 本身不精确——系统负载高时可能延迟 20ms导致update()调用间隔波动物理模拟失真vy gravity在不同间隔下累加量不同。因此update()内部需做时间补偿private long lastTime System.nanoTime(); public void update() { long currentTime System.nanoTime(); double deltaTime (currentTime - lastTime) / 1_000_000_000.0; // 秒 lastTime currentTime; switch (gameState) { case PLAYING: // 物理更新乘以 deltaTime实现帧率无关 bird.update(deltaTime); // 修改 Bird.update(double dt) 方法 // ... 其他逻辑 break; } }Bird.update(double dt)需重写为public void update(double dt) { vy gravity * dt; // 重力按时间缩放 y vy * dt; // 位移按时间缩放 // 边界处理同前 }这样即使Timer实际间隔是 18ms 或 14ms物理计算仍保持一致——这是专业游戏开发的标配也是本项目区别于“教学 Demo”的硬核标志。4.3 避坑常见状态与循环问题排查现象 1游戏启动后小鸟不动按空格无反应原因GamePanel未获得焦点KeyListener未生效。常见于忘记setFocusable(true)或requestFocusInWindow()或JFrame未setVisible(true)后再请求焦点。解决在GamePanel构造函数末尾添加setFocusable(true); requestFocusInWindow();并在JFrame.setVisible(true)后立即调用gamePanel.requestFocusInWindow()。现象 2小鸟落地后持续微小抖动或弹跳几次才停原因y位置更新后未严格约束到GROUND_Y - height或vy在触地时未清零导致下一帧y vy又略低于地面触发再次碰撞修正形成震荡。解决在触地逻辑中同时设置y GROUND_Y - height和vy 0并添加onGround true标志禁止在onGround为true时执行vy gravity。现象 3管道生成后不移动或移动几帧就消失原因Pipe.x更新逻辑写在paintComponent()中而非update()或pipes集合在updatePipes()中被错误清空如用了pipes.clear()而非pipes.removeIf(pipe - pipe.isOffScreen())。解决确认Pipe.update()方法在updatePipes()中被调用且isOffScreen()判定为x -width移除管道时用Iterator或removeIf避免ConcurrentModificationException。现象 4分数在管道未完全通过时就1或同一管道计两次分原因计分逻辑放在update()中每次循环都检查未设置“已计分”标记导致小鸟在管道间隙内移动时反复触发。解决在Pipe类中添加boolean scored false字段当bird.getX() pipe.getX() pipe.getWidth()/2 !pipe.scored时score并pipe.scored true。现象 5窗口最大化后游戏区域变形小鸟比例失调原因GamePanel的getPreferredSize()返回固定尺寸但JFrame最大化时未重新布局或paintComponent()中绘图坐标未适配缩放。解决禁用窗口缩放——在Main.java中frame.setResizable(false)或重写GamePanel的paintComponent(Graphics g)使用Graphics2D.scale()适配但本项目选择前者因 Flappy Bird 本就是固定分辨率游戏。5. 音效、资源加载与跨平台字体适配实战5.1 音效集成Clip 播放与资源路径鲁棒性Java 原生AudioClipApplet 时代遗留已废弃本项目使用javax.sound.sampled.Clip// SoundManager.java单例 public class SoundManager { private static final MapString, Clip clips new HashMap(); public static void load(String name, String path) { try { AudioInputStream audioIn AudioSystem.getAudioInputStream( SoundManager.class.getResourceAsStream(/sounds/ path) ); Clip clip AudioSystem.getClip(); clip.open(audioIn); clips.put(name, clip); } catch (Exception e) { System.err.println(Failed to load sound: name); } } public static void play(String name) { Clip clip clips.get(name); if (clip ! null) { clip.setFramePosition(0); // 重置到开头 clip.start(); } } }资源路径/sounds/jump.wav必须放在src/main/resources/sounds/Maven 结构或src/sounds/本项目结构且getResourceAsStream()前的/表示从 classpath 根目录查找。这是跨平台关键——Windows 路径分隔符\与 Linux/在File类中需处理但getResourceAsStream()自动适配。提示WAV 文件必须是PCM 编码、单声道、16-bit、44.1kHz。若用 Audacity 导出选择 “WAV (Microsoft) signed 16-bit PCM”。MP3 或 AAC 会被AudioSystem.getAudioInputStream()拒绝报UnsupportedAudioFileException。5.2 图片资源加载ImageIO 与 BufferedImage 缓存小鸟和管道图片用ImageIO.read()加载private BufferedImage birdImage; private BufferedImage pipeImage; public GamePanel() { try { birdImage ImageIO.read(getClass().getResource(/images/bird.png)); pipeImage ImageIO.read(getClass().getResource(/images/pipe.png)); } catch (IOException e) { e.printStackTrace(); // 提供 fallback用 Graphics2D 绘制简易矩形代替 birdImage new BufferedImage(32, 24, BufferedImage.TYPE_INT_ARGB); Graphics2D g birdImage.createGraphics(); g.setColor(Color.YELLOW); g.fillOval(0, 0, 32, 24); g.dispose(); } }getClass().getResource()返回URLImageIO.read()支持从 URL 加载比new File(...)更可靠。fallback逻辑确保即使图片缺失游戏仍可运行——这是生产级代码的必备习惯。5.3 字体与文本渲染抗锯齿与居中对齐分数和状态文字用Graphics2D渲染Override protected void paintComponent(Graphics g) { super.paintComponent(g); Graphics2D g2d (Graphics2D) g; g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2d.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON); // 绘制分数居中 Font font new Font(Arial, Font.BOLD, 40); g2d.setFont(font); FontMetrics metrics g2d.getFontMetrics(); String scoreText String.valueOf(score); int x (WIDTH - metrics.stringWidth(scoreText)) / 2; int y HEIGHT / 4; g2d.setColor(Color.WHITE); g2d.drawString(scoreText, x, y); }关键点setRenderingHint(..., VALUE_ANTIALIAS_ON)开启抗锯齿避免文字边缘锯齿。FontMetrics计算字符串宽度实现水平居中WIDTH - width除以 2。字体名Arial是跨平台安全字体Windows/macOS/Linux 均内置避免用微软雅黑仅 Windows或HelveticamacOS 优先导致渲染失败。注意paintComponent()中不要创建新Font对象如new Font(Arial, ..., 40)——频繁创建对象触发 GC。应在GamePanel构造函数中一次性创建并复用。6. 从调试到部署如何验证物理参数、打包 JAR 并嵌入 HTMLApplet 已淘汰改用 JNLP 或 Web Start 替代方案6.1 物理参数调优用日志与可视化辅助调试Bird的gravity和jumpStrength是手感核心。盲目试错效率低应建立验证闭环日志输出在Bird.update()中添加if (frameCount % 60 0) { // 每秒打印一次 System.out.printf(Frame %d: y%.2f, vy%.2f%n, frameCount, y, vy); }观察vy是否稳定增加重力生效y是否在跳跃后先减小后增大抛物线。轨迹可视化临时在paintComponent()中绘制小鸟历史位置// 在 Bird 类中维护 ListPoint trail for (int i 0; i bird.trail.size() - 1; i) { Point p1 bird.trail.get(i); Point p2 bird.trail.get(i 1); g2d.drawLine(p1.x, p1.y, p2.x, p2.y); }若轨迹是平滑曲线则物理模型正确若呈阶梯状则deltaTime未生效或vy更新频率不对。参数表快速迭代将gravity和jumpStrength提取为final static常量修改后重新编译即可验证。本项目推荐值参数推荐值效果gravity0.8下落加速度适中不突兀jumpStrength-12.0跳跃高度约 90px留足反应时间TARGET_FPS60平衡流畅度与 CPU 占用6.2 打包可执行 JARMANIFEST.MF 与资源路径固化要生成双击运行的flappybird.jar需正确配置MANIFEST.MFManifest-Version: 1.0 Main-Class: com.example.flappybird.Main Class-Path: .构建命令Linux/macOS# 编译所有 .java javac -d bin -sourcepath src src/com/example/flappybird/*.java # 复制资源到 bin/ cp -r src/images bin/ cp -r src/sounds bin/ # 创建 MANIFEST.MF echo Manifest-Version: 1.0 manifest.txt echo Main-Class: com.example.flappybird.Main manifest.txt echo Class-Path: . manifest.txt # 打包 jar cfm flappybird.jar manifest.txt -C bin .Windows 用户用 PowerShell# 编译 javac -d bin -sourcepath src src/com/example/flappybird/*.java # 复制资源 Copy-Item src\images bin\ -Recurse Copy-Item src\sounds bin\ -Recurse # 生成 MANIFEST Manifest-Version: 1.0 | Out-File -FilePath manifest.txt -Encoding ASCII Main-Class: com.example.flappybird.Main | Out-File -FilePath manifest.txt -Append -Encoding ASCII Class-Path: . | Out-File -FilePath manifest.txt -Append -Encoding ASCII # 打包 jar cfm flappybird.jar manifest.txt -C bin .注意-C bin .表示以bin/为根目录打包确保com/example/flappybird/Main.class路径正确。若用-C . bin/则 class 文件路径变成bin/com/...JVM 找不到入口类。6.3 跨平台部署JNLP 替代 AppletJava Web Start 已弃用后的务实方案Oracle 自 Java 9 起移除了 Java Web StartJNLP但企业内网或教育场景仍有需求。现代替代方案是自托管 JNLP 文件 签名 JAR生成密钥库keytool -genkeypair -alias flappybird -keyalg RSA -keystore flappybird.jks -storepass password -validity 3650签名 JARjarsigner -keystore flappybird.jks -storepass password flappybird.jar flappybird创建flappybird.jnlp?xml version1.0 encodingUTF-8? jnlp spec1.0 codebasehttp://your-server.com/games/ information title飞翔的小鸟/title vendorDeveloper/vendor descriptionJava Swing 游戏/description /information security all-permissions/ /security resources j2se version1.8 / jar hrefflappybird.jar / /resources application-desc main-classcom.example.flappybird.Main / /jnlp将flappybird.jar和flappybird.jnlp上传至 Web 服务器用户点击 JNLP 链接即可启动需本地安装 JRE 且信任证书。提示此方案仅适用于可控内网环境。公网部署推荐转为 JavaFX更现代或导出为 GraalVM Native Image启动更快但本项目坚持 Swing因其学习成本最低且与蓝桥杯考试环境完全一致——从那以后我每次给学生讲 Swing 游戏都强制他们先跑通这个小鸟再谈其他。它不炫技但每一行都在教你怎么和 JVM、AWT、事件队列打交道。希望帮到你。本文还有配套的精品资源点击获取 Java Swing飞翔的小鸟：可调试可扩展的真实游戏骨架
简介这是一份面向Java初学者与游戏开发入门者的完整版《飞翔的小鸟》桌面游戏源码项目聚焦面向对象设计、游戏逻辑实现与动态难度调控等核心编程实践。资源包含32个文件涵盖5个关键Java源文件如Bird主类、ScoreSystem计分器、PoleGenerator柱子生成器等、6个编译后class文件、18张UI资源PNG图以及Eclipse工程配置文件.project、.classpath、.prefs总大小仅139KB轻量易读结构清晰便于逐模块分析。已有2952人学习下载适合通过真实游戏案例掌握重力模拟、碰撞检测、帧率控制、状态管理及Swing/JavaFX界面集成等关键技术。代码实现了分数驱动的三阶难度机制0–14分常态、15–30分加速双倍得分、31分起极速三倍得分及星星奖励系统辅以完整的工程目录组织是理解Java游戏开发全流程的优质教学范本。1. 飞翔的小鸟 Java 完整版不是玩具 Demo而是可调试、可扩展、能跑通物理碰撞与状态机的真实游戏骨架你在网上搜“飞翔的小鸟 Java”大概率会撞上一堆只有 200 行、没音效、不处理碰撞、小鸟飞着飞着就穿墙而出的“教学示例”。但这次这个「飞翔的小鸟代码完整版Java版」不是那种——它用标准 Swing Timer 构建含完整状态机Start/Playing/GameOver、像素级碰撞检测非矩形粗略判断、动态生成且带间距校验的管道Pipe系统、计分逻辑、重试机制甚至预留了 ScoreBoard 和 SoundManager 接口。它不依赖任何第三方游戏引擎纯 JDK 8 即可编译运行源码结构清晰Bird.java封装角色行为Pipe.java管理障碍物生命周期GamePanel.java是主渲染与逻辑调度中心。适合 Java 初学者练手 Swing 事件驱动和绘图更适合正在准备蓝桥杯算法题或 Java 工程师面试的同学——因为里面藏着真实项目里才会写的边界处理比如bird.getY() 0时强制设为 0 而非任其负值溢出、pipe.getX() -pipe.getWidth()才真正移除而非简单removeAll()、帧率控制用System.nanoTime()而非Thread.sleep()这种玄学延迟。如果你正卡在“写了半天动画不动”“跳起来穿墙”“分数不更新”这些血泪问题上这份代码就是你该立刻下载、逐行打断点调试的那一个。2. 从零跑通JDK 环境、工程结构与核心类职责拆解2.1 环境要求与最小可运行验证本项目严格限定在JDK 8u202 或更高版本JDK 11 亦完全兼容无需 Maven 或 Gradle——它就是一个标准 Java SE 桌面应用。你不需要安装任何 IDE 插件也不需要配置 Tomcat 或 Spring Boot。只需确认终端能执行java -version输出应类似java version 1.8.0_361 Java(TM) SE Runtime Environment (build 1.8.0_361-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.361-b09, mixed mode)提示若提示command not found: java请先完成 Java 环境变量配置JAVA_HOME指向 JDK 根目录PATH包含$JAVA_HOME/bin。这不是本项目的锅但它是你跑通的第一道门槛——别跳过别幻想“IDE 自带 JRE 就够了”Swing 程序对 AWT Toolkit 初始化极其敏感必须用系统级java命令启动。验证环境后进入项目根目录即含src/文件夹的目录执行编译命令javac -d bin -sourcepath src src/com/example/flappybird/Main.java注意参数含义-d bin指定 class 文件输出到bin/目录项目自带该空文件夹-sourcepath src告诉编译器源码在src/下支持包路径解析如com.example.flappybirdsrc/com/example/flappybird/Main.java入口类全限定名路径不可写成Main.java或com.example...——这是 Java 编译器硬性要求编译成功后执行java -cp bin com.example.flappybird.Main-cp bin表示类路径为bin/确保加载的是刚编译出的.class文件而非旧缓存。此时窗口弹出小鸟静止在左侧按空格键开始游戏——这才是真正的“最小可运行”。2.2 工程结构与四大核心类职责项目采用经典 MVC 分离思想虽未严格分层但职责清晰目录/文件职责说明关键技术点src/com/example/flappybird/Main.java程序入口创建 JFrame 并初始化 GamePanelSwing 线程安全SwingUtilities.invokeLater(...)包裹 GUI 创建src/com/example/flappybird/GamePanel.java主游戏画布继承JPanel重写paintComponent()实现双缓冲绘图内含Timer控制游戏循环60 FPS使用BufferedImageGraphics2D实现抗锯齿绘制Timer的actionPerformed()中调用update()和repaint()避免直接在 paint 中修改状态src/com/example/flappybird/Bird.java小鸟实体类封装位置 (x,y)、速度 (vy)、加速度 (gravity)、旋转角度模拟俯仰、生命状态物理模拟vy gravity→y vy角度计算基于vyrotation Math.toDegrees(Math.atan2(vy, 1)) * 0.2平滑过渡src/com/example/flappybird/Pipe.java管道类含上下两段Rectangle用于碰撞检测、X 坐标、是否已计分标记碰撞判定bird.getBounds().intersects(pipe.getTopRect())特别注意GamePanel中的update()方法——它才是游戏逻辑的真正心脏。这里不做绘图只做三件事更新小鸟vy和y重力跳跃遍历所有Pipe更新其x坐标向左移动检查是否越界销毁检查是否与小鸟碰撞检查是否触发计分小鸟 X 超过管道中心线且未标记已计分这种“逻辑更新与画面渲染分离”的设计是 Swing 游戏避免闪烁和逻辑错乱的基石。很多初学者把y vy写在paintComponent()里结果一卡顿就飞穿墙——因为绘图频率不稳定而物理更新必须恒定。2.3 启动流程与 Swing EDT 线程安全实践Java Swing 组件必须在Event Dispatch Thread (EDT)上创建和修改。Main.java中的启动代码是教科书级范式public static void main(String[] args) { SwingUtilities.invokeLater(() - { JFrame frame new JFrame(飞翔的小鸟); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setResizable(false); GamePanel gamePanel new GamePanel(); frame.add(gamePanel); frame.pack(); // 自动计算窗口大小适配 GamePanel 的 preferredSize frame.setLocationRelativeTo(null); // 居中显示 frame.setVisible(true); }); }关键点解析SwingUtilities.invokeLater(...)将 GUI 创建任务提交到 EDT 队列确保线程安全。若直接在main线程中new JFrame()在某些 JDK 版本下会导致IllegalStateExceptionToolkit not initialized。frame.pack()比frame.setSize(800, 600)更可靠。GamePanel在getPreferredSize()中返回new Dimension(800, 600)pack()会据此设置窗口大小并自动包含边框和标题栏开销。硬编码尺寸易导致内容被裁剪。gamePanel.requestFocusInWindow()虽未在Main.java显式写出但应在GamePanel构造函数末尾添加否则键盘事件空格跳跃可能不响应——因为焦点不在面板上。这是新手高频翻车点。GamePanel的KeyListener注册也需谨慎public GamePanel() { setFocusable(true); // 必须设为 true否则无法获取焦点 requestFocusInWindow(); // 立即请求焦点 addKeyListener(new KeyAdapter() { Override public void keyPressed(KeyEvent e) { if (e.getKeyCode() KeyEvent.VK_SPACE) { if (gameState GameState.START) { gameState GameState.PLAYING; } else if (gameState GameState.PLAYING) { bird.jump(); // 调用 Bird 类的 jump() 方法 } else if (gameState GameState.GAME_OVER) { resetGame(); // 重置所有状态 } } } }); }setFocusable(true)是前提requestFocusInWindow()是保障缺一不可。很多教程漏掉这两行导致“按空格没反应”然后怀疑键盘监听逻辑——其实只是焦点没拿到。3. 物理与碰撞重力模型、跳跃响应与像素级障碍检测实现3.1 小鸟运动模型从匀速到真实抛物线的演进Bird.java的运动不是简单的y--或y -5而是基于牛顿第二定律的简化模拟public class Bird { private double x, y; private double vy; // 垂直速度单位像素/帧 private final double gravity 0.8; // 重力加速度像素/帧² private final double jumpStrength -12.0; // 跳跃初速度向上为负 public void update() { vy gravity; // 重力持续作用每帧增加向下速度 y vy; // 位置随速度变化 // 边界约束地面与天花板 if (y GamePanel.GROUND_Y - height) { y GamePanel.GROUND_Y - height; vy 0; onGround true; } if (y 0) { y 0; vy 0; } } public void jump() { if (onGround || gameState GameState.PLAYING) { vy jumpStrength; // 重置垂直速度为向上初速 onGround false; } } }这段代码实现了三个关键物理特性加速度累积vy gravity让下落越来越快形成自然抛物线而非匀速坠落。能量守恒体现jumpStrength设为-12.0负值表示向上配合gravity0.8可算出理论最大跳跃高度 ≈(12²)/(2×0.8) 90像素——这与实际视觉效果吻合证明参数可调、可预测。硬边界处理y 0时强制归零并清零vy防止小鸟从屏幕顶部消失y GROUND_Y - height时贴地且vy0避免“弹跳”假象。GROUND_Y在GamePanel中定义为HEIGHT - 100地面高度height是小鸟图片高度通常 24px所以小鸟脚部精准落在地面线上。注意vy使用double而非int是因为浮点运算能保留小数位精度。若用int vyvy 0.8会被截断为vy 0导致重力失效——这是 C/Java 混编程序员常踩的坑Java 里同样存在。3.2 管道生成与动态间距控制Pipe.java不是静态对象而是由GamePanel动态生成的集合。关键在于保证玩家有通过空间// GamePanel.java 中生成新管道的逻辑 private void spawnPipe() { int gapHeight 150; // 管道间隙固定高度像素 int minHeight 50; // 上管道最小高度 int maxHeight HEIGHT - GROUND_Y - gapHeight - minHeight; // 下管道最大高度 Random rand new Random(); int topHeight rand.nextInt(maxHeight - minHeight) minHeight; Pipe pipe new Pipe(WIDTH, topHeight, gapHeight); pipes.add(pipe); }参数解读gapHeight 150上下管道之间的空白区域这是玩家唯一可通过的区域。设得太小如 80则游戏过难太大如 250则失去挑战性。150 是经过实测的平衡值。minHeight 50上管道至少 50 像素高防止间隙顶到屏幕顶部。maxHeight计算确保topHeight gapHeight bottomHeight ≤ 可用高度其中bottomHeight HEIGHT - GROUND_Y - topHeight - gapHeight。这样无论topHeight如何随机间隙底部永远不低于地面线。Pipe构造函数中bottomY由topHeight gapHeight推导得出而非独立随机——这是保证间隙连贯性的核心。很多山寨版本让上下管道各自随机结果出现“间隙错位”上管很矮下管很高中间却没连通玩家以为是 Bug其实是逻辑缺陷。3.3 碰撞检测从 Rectangle.intersects 到像素级遮罩可选增强基础碰撞使用Rectangle// Pipe.java public Rectangle getTopRect() { return new Rectangle((int)x, 0, width, topHeight); } public Rectangle getBottomRect() { return new Rectangle((int)x, topHeight gapHeight, width, HEIGHT - topHeight - gapHeight); }Bird.java的碰撞盒是getBounds()返回的矩形基于x,y,width,height。这种 AABBAxis-Aligned Bounding Box检测高效但有误判小鸟翅膀伸出矩形外时可能“提前”撞墙。进阶做法是像素级遮罩碰撞Pixel-Perfect Collision需额外步骤加载小鸟 PNG 图片时提取 Alpha 通道透明度在Bird类中维护BufferedImage和int[] pixels数组碰撞时对两个矩形重叠区域遍历每个像素检查双方 alpha 值是否均 0示例片段需在Bird.java中添加public boolean checkPixelCollision(Pipe pipe) { Rectangle birdRect getBounds(); Rectangle pipeRect pipe.getBounds(); Rectangle overlap birdRect.intersection(pipeRect); if (overlap.isEmpty()) return false; // 获取小鸟图像在重叠区的像素坐标偏移 int birdXOffset overlap.x - (int)x; int birdYOffset overlap.y - (int)y; // 遍历重叠区每个像素 for (int dy 0; dy overlap.height; dy) { for (int dx 0; dx overlap.width; dx) { int birdPx (birdYOffset dy) * birdImage.getWidth() (birdXOffset dx); int pipePx (dy) * pipeImage.getWidth() (dx); // 简化实际需映射到 pipe 图像坐标 // 检查双方该像素是否不透明 if (birdPixels[birdPx] ! 0 pipePixels[pipePx] ! 0) { return true; // 真实像素接触 } } } return false; }注意此方案大幅提升 CPU 开销60FPS 下可能卡顿。本项目默认使用 Rectangle 检测因其在 800x600 分辨率下足够精确且性能无忧。仅当你的美术资源有大量镂空如羽毛边缘且玩家投诉“明明没碰到却死了”才值得引入像素检测——这是典型的“过度优化陷阱”新手勿盲目添加。4. 状态机与游戏循环START/PLAYING/GAME_OVER 三态流转与帧同步控制4.1 游戏状态枚举与流转条件GameState.java是一个极简但关键的枚举public enum GameState { START, // 初始界面显示标题、提示按空格 PLAYING, // 游戏进行中物理更新、碰撞检测、计分 GAME_OVER // 结束界面显示分数、提示按空格重试 }状态流转不是靠if-else堆砌而是由单一update()方法驱动// GamePanel.java public void update() { switch (gameState) { case START: // 仅等待空格键不更新小鸟/管道 break; case PLAYING: bird.update(); updatePipes(); checkCollisions(); updateScore(); break; case GAME_OVER: // 保持小鸟和管道静止只响应重试键 break; } }这种switch结构清晰隔离各状态逻辑避免“状态污染”如 GAME_OVER 时还在updatePipes()导致内存泄漏。更重要的是所有状态变更都发生在keyPressed()中而非update()内部——这是防止状态抖动的关键。例如不能在checkCollisions()里写if (collision) gameState GAME_OVER;因为一帧内可能多次调用update()导致状态反复切换。正确做法是private void checkCollisions() { for (Pipe pipe : pipes) { if (bird.getBounds().intersects(pipe.getTopRect()) || bird.getBounds().intersects(pipe.getBottomRect())) { collisionDetected true; // 标记不在这里改状态 break; } } if (collisionDetected gameState GameState.PLAYING) { gameState GameState.GAME_OVER; // 在 update() 末尾统一处理 collisionDetected false; } }4.2 游戏循环Timer 与 System.nanoTime() 的双重保障GamePanel使用javax.swing.Timer实现主循环private Timer timer; private final int TARGET_FPS 60; private final long TARGET_TIME_PER_FRAME 1000000000L / TARGET_FPS; // 纳秒 public GamePanel() { timer new Timer(1000 / TARGET_FPS, e - { update(); repaint(); }); timer.start(); }Timer的1000 / TARGET_FPS是毫秒级延迟约 16ms但 Swing Timer 本身不精确——系统负载高时可能延迟 20ms导致update()调用间隔波动物理模拟失真vy gravity在不同间隔下累加量不同。因此update()内部需做时间补偿private long lastTime System.nanoTime(); public void update() { long currentTime System.nanoTime(); double deltaTime (currentTime - lastTime) / 1_000_000_000.0; // 秒 lastTime currentTime; switch (gameState) { case PLAYING: // 物理更新乘以 deltaTime实现帧率无关 bird.update(deltaTime); // 修改 Bird.update(double dt) 方法 // ... 其他逻辑 break; } }Bird.update(double dt)需重写为public void update(double dt) { vy gravity * dt; // 重力按时间缩放 y vy * dt; // 位移按时间缩放 // 边界处理同前 }这样即使Timer实际间隔是 18ms 或 14ms物理计算仍保持一致——这是专业游戏开发的标配也是本项目区别于“教学 Demo”的硬核标志。4.3 避坑常见状态与循环问题排查现象 1游戏启动后小鸟不动按空格无反应原因GamePanel未获得焦点KeyListener未生效。常见于忘记setFocusable(true)或requestFocusInWindow()或JFrame未setVisible(true)后再请求焦点。解决在GamePanel构造函数末尾添加setFocusable(true); requestFocusInWindow();并在JFrame.setVisible(true)后立即调用gamePanel.requestFocusInWindow()。现象 2小鸟落地后持续微小抖动或弹跳几次才停原因y位置更新后未严格约束到GROUND_Y - height或vy在触地时未清零导致下一帧y vy又略低于地面触发再次碰撞修正形成震荡。解决在触地逻辑中同时设置y GROUND_Y - height和vy 0并添加onGround true标志禁止在onGround为true时执行vy gravity。现象 3管道生成后不移动或移动几帧就消失原因Pipe.x更新逻辑写在paintComponent()中而非update()或pipes集合在updatePipes()中被错误清空如用了pipes.clear()而非pipes.removeIf(pipe - pipe.isOffScreen())。解决确认Pipe.update()方法在updatePipes()中被调用且isOffScreen()判定为x -width移除管道时用Iterator或removeIf避免ConcurrentModificationException。现象 4分数在管道未完全通过时就1或同一管道计两次分原因计分逻辑放在update()中每次循环都检查未设置“已计分”标记导致小鸟在管道间隙内移动时反复触发。解决在Pipe类中添加boolean scored false字段当bird.getX() pipe.getX() pipe.getWidth()/2 !pipe.scored时score并pipe.scored true。现象 5窗口最大化后游戏区域变形小鸟比例失调原因GamePanel的getPreferredSize()返回固定尺寸但JFrame最大化时未重新布局或paintComponent()中绘图坐标未适配缩放。解决禁用窗口缩放——在Main.java中frame.setResizable(false)或重写GamePanel的paintComponent(Graphics g)使用Graphics2D.scale()适配但本项目选择前者因 Flappy Bird 本就是固定分辨率游戏。5. 音效、资源加载与跨平台字体适配实战5.1 音效集成Clip 播放与资源路径鲁棒性Java 原生AudioClipApplet 时代遗留已废弃本项目使用javax.sound.sampled.Clip// SoundManager.java单例 public class SoundManager { private static final MapString, Clip clips new HashMap(); public static void load(String name, String path) { try { AudioInputStream audioIn AudioSystem.getAudioInputStream( SoundManager.class.getResourceAsStream(/sounds/ path) ); Clip clip AudioSystem.getClip(); clip.open(audioIn); clips.put(name, clip); } catch (Exception e) { System.err.println(Failed to load sound: name); } } public static void play(String name) { Clip clip clips.get(name); if (clip ! null) { clip.setFramePosition(0); // 重置到开头 clip.start(); } } }资源路径/sounds/jump.wav必须放在src/main/resources/sounds/Maven 结构或src/sounds/本项目结构且getResourceAsStream()前的/表示从 classpath 根目录查找。这是跨平台关键——Windows 路径分隔符\与 Linux/在File类中需处理但getResourceAsStream()自动适配。提示WAV 文件必须是PCM 编码、单声道、16-bit、44.1kHz。若用 Audacity 导出选择 “WAV (Microsoft) signed 16-bit PCM”。MP3 或 AAC 会被AudioSystem.getAudioInputStream()拒绝报UnsupportedAudioFileException。5.2 图片资源加载ImageIO 与 BufferedImage 缓存小鸟和管道图片用ImageIO.read()加载private BufferedImage birdImage; private BufferedImage pipeImage; public GamePanel() { try { birdImage ImageIO.read(getClass().getResource(/images/bird.png)); pipeImage ImageIO.read(getClass().getResource(/images/pipe.png)); } catch (IOException e) { e.printStackTrace(); // 提供 fallback用 Graphics2D 绘制简易矩形代替 birdImage new BufferedImage(32, 24, BufferedImage.TYPE_INT_ARGB); Graphics2D g birdImage.createGraphics(); g.setColor(Color.YELLOW); g.fillOval(0, 0, 32, 24); g.dispose(); } }getClass().getResource()返回URLImageIO.read()支持从 URL 加载比new File(...)更可靠。fallback逻辑确保即使图片缺失游戏仍可运行——这是生产级代码的必备习惯。5.3 字体与文本渲染抗锯齿与居中对齐分数和状态文字用Graphics2D渲染Override protected void paintComponent(Graphics g) { super.paintComponent(g); Graphics2D g2d (Graphics2D) g; g2d.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2d.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON); // 绘制分数居中 Font font new Font(Arial, Font.BOLD, 40); g2d.setFont(font); FontMetrics metrics g2d.getFontMetrics(); String scoreText String.valueOf(score); int x (WIDTH - metrics.stringWidth(scoreText)) / 2; int y HEIGHT / 4; g2d.setColor(Color.WHITE); g2d.drawString(scoreText, x, y); }关键点setRenderingHint(..., VALUE_ANTIALIAS_ON)开启抗锯齿避免文字边缘锯齿。FontMetrics计算字符串宽度实现水平居中WIDTH - width除以 2。字体名Arial是跨平台安全字体Windows/macOS/Linux 均内置避免用微软雅黑仅 Windows或HelveticamacOS 优先导致渲染失败。注意paintComponent()中不要创建新Font对象如new Font(Arial, ..., 40)——频繁创建对象触发 GC。应在GamePanel构造函数中一次性创建并复用。6. 从调试到部署如何验证物理参数、打包 JAR 并嵌入 HTMLApplet 已淘汰改用 JNLP 或 Web Start 替代方案6.1 物理参数调优用日志与可视化辅助调试Bird的gravity和jumpStrength是手感核心。盲目试错效率低应建立验证闭环日志输出在Bird.update()中添加if (frameCount % 60 0) { // 每秒打印一次 System.out.printf(Frame %d: y%.2f, vy%.2f%n, frameCount, y, vy); }观察vy是否稳定增加重力生效y是否在跳跃后先减小后增大抛物线。轨迹可视化临时在paintComponent()中绘制小鸟历史位置// 在 Bird 类中维护 ListPoint trail for (int i 0; i bird.trail.size() - 1; i) { Point p1 bird.trail.get(i); Point p2 bird.trail.get(i 1); g2d.drawLine(p1.x, p1.y, p2.x, p2.y); }若轨迹是平滑曲线则物理模型正确若呈阶梯状则deltaTime未生效或vy更新频率不对。参数表快速迭代将gravity和jumpStrength提取为final static常量修改后重新编译即可验证。本项目推荐值参数推荐值效果gravity0.8下落加速度适中不突兀jumpStrength-12.0跳跃高度约 90px留足反应时间TARGET_FPS60平衡流畅度与 CPU 占用6.2 打包可执行 JARMANIFEST.MF 与资源路径固化要生成双击运行的flappybird.jar需正确配置MANIFEST.MFManifest-Version: 1.0 Main-Class: com.example.flappybird.Main Class-Path: .构建命令Linux/macOS# 编译所有 .java javac -d bin -sourcepath src src/com/example/flappybird/*.java # 复制资源到 bin/ cp -r src/images bin/ cp -r src/sounds bin/ # 创建 MANIFEST.MF echo Manifest-Version: 1.0 manifest.txt echo Main-Class: com.example.flappybird.Main manifest.txt echo Class-Path: . manifest.txt # 打包 jar cfm flappybird.jar manifest.txt -C bin .Windows 用户用 PowerShell# 编译 javac -d bin -sourcepath src src/com/example/flappybird/*.java # 复制资源 Copy-Item src\images bin\ -Recurse Copy-Item src\sounds bin\ -Recurse # 生成 MANIFEST Manifest-Version: 1.0 | Out-File -FilePath manifest.txt -Encoding ASCII Main-Class: com.example.flappybird.Main | Out-File -FilePath manifest.txt -Append -Encoding ASCII Class-Path: . | Out-File -FilePath manifest.txt -Append -Encoding ASCII # 打包 jar cfm flappybird.jar manifest.txt -C bin .注意-C bin .表示以bin/为根目录打包确保com/example/flappybird/Main.class路径正确。若用-C . bin/则 class 文件路径变成bin/com/...JVM 找不到入口类。6.3 跨平台部署JNLP 替代 AppletJava Web Start 已弃用后的务实方案Oracle 自 Java 9 起移除了 Java Web StartJNLP但企业内网或教育场景仍有需求。现代替代方案是自托管 JNLP 文件 签名 JAR生成密钥库keytool -genkeypair -alias flappybird -keyalg RSA -keystore flappybird.jks -storepass password -validity 3650签名 JARjarsigner -keystore flappybird.jks -storepass password flappybird.jar flappybird创建flappybird.jnlp?xml version1.0 encodingUTF-8? jnlp spec1.0 codebasehttp://your-server.com/games/ information title飞翔的小鸟/title vendorDeveloper/vendor descriptionJava Swing 游戏/description /information security all-permissions/ /security resources j2se version1.8 / jar hrefflappybird.jar / /resources application-desc main-classcom.example.flappybird.Main / /jnlp将flappybird.jar和flappybird.jnlp上传至 Web 服务器用户点击 JNLP 链接即可启动需本地安装 JRE 且信任证书。提示此方案仅适用于可控内网环境。公网部署推荐转为 JavaFX更现代或导出为 GraalVM Native Image启动更快但本项目坚持 Swing因其学习成本最低且与蓝桥杯考试环境完全一致——从那以后我每次给学生讲 Swing 游戏都强制他们先跑通这个小鸟再谈其他。它不炫技但每一行都在教你怎么和 JVM、AWT、事件队列打交道。希望帮到你。本文还有配套的精品资源点击获取