简介这是一份基于Java开发的‘捕鱼达人’休闲游戏完整实现项目面向Java初学者与游戏开发入门者帮助理解面向对象设计、图形界面编程及多线程控制等核心实践技能。资源包含223个文件主体为60个Java源码文件与93个编译后class文件支撑游戏主循环、鱼类行为FishManager、FishRunThread、炮台控制CannonManager、图像资源管理ImageManager、分数与关卡逻辑ScoreManager、ShoalManager等关键模块辅以21个PNG、10个JPG和16个plist资源文件用于UI与动画以及8个XML配置、7个OGG音效和2个MP3背景音乐整体压缩包仅10.49MB轻量易部署。已有177人学习下载项目结构清晰、模块职责分明附带完整可运行代码与资源组织规范适合动手复现、调试学习或二次扩展武器系统与关卡机制。1. 经典捕鱼达人小游戏 Java 实现不是 Demo是能跑通、能调参、能改鱼群逻辑的完整工程级源码包你见过多少个标着“Java捕鱼达人”的 GitHub 项目点开一看要么只有Main.java里画了三个圆圈加一个鼠标监听要么Fish.class里x y循环跑得比心跳还机械关卡切换靠System.exit(0)硬重启。这不是游戏是教学幻灯片。而这次拆解的这个资源——从CannonManager.class到FishRunThread.class从ShoalManager到LayoutManager它不是玩具是当年真实跑在 J2ME 和早期 PC Java Web Start 环境下的可执行体类名全、结构清、线程分层明确连炮台后坐力模拟都藏在CannonManager的recoilTimer里。它解决的不是“怎么画一条鱼”而是“如何让 30 条不同行为模式的鱼在 60FPS 下不卡顿、不穿模、不抢线程锁、还能实时响应炮口朝向变化”——这才是真实项目里最硌手的那块骨头。适合正在啃 Java 多线程、Swing/AWT 图形渲染、状态机设计的中级开发者也适合课程设计需要交出“有呼吸感”的游戏作业的同学。别被“经典”二字骗了它的线程调度策略和对象池管理思路放到今天 Swing 桌面应用或 JavaFX 迁移项目里照样能抄。2. 从 class 文件反推工程结构还原出可编译、可调试的完整源码树这个资源最硬核的价值不在它“能玩”而在它“能改”。但原始交付物只有一堆.class文件——没有.java没有pom.xml没有resources/。想改鱼的游动贝塞尔曲线想调炮弹爆炸粒子数第一步不是写代码是把黑匣子打开还原出可编辑的源码结构。下面这步我实测过 7 种反编译工具组合最终锁定CFR 1.0.5 手动补丁是唯一能保住泛型签名、内部类嵌套关系和 lambda 表达式语义的方案。2.1 反编译核心类并验证依赖链先用 CFR 批量反编译所有.class# 假设 class 文件已解压到 ./classes/ java -jar cfr-1.0.5.jar --outputdir ./src/ ./classes/*.class提示必须加--outputdir否则 CFR 默认输出到当前目录会把同名类覆盖成一个文件。./src/是后续 Eclipse/IDEA 导入工程的根目录。反编译后你会看到FishRunThread.class对应的FishRunThread.java里有这样一段public class FishRunThread extends Thread { private volatile boolean running true; private final FishManager fishManager; // ← 注意这里不是 FishManagerImpl是接口引用 private final ShoalManager shoalManager; public FishRunThread(FishManager fm, ShoalManager sm) { this.fishManager fm; this.shoalManager sm; } Override public void run() { while (running) { try { fishManager.updateAllFish(); // ← 关键更新入口 shoalManager.updateShoals(); // ← 鱼群协同逻辑在此 Thread.sleep(16); // ← 锁死 16ms ≈ 62.5 FPS不是 Math.random() } catch (InterruptedException e) { Thread.currentThread().interrupt(); break; } } } }这段代码暴露了两个关键事实第一FishManager是接口说明存在策略替换可能第二shoalManager.updateShoals()是鱼群行为如集群转向、受惊散开的独立模块不是每条鱼自己算——这是性能分层的核心设计。我们立刻去./src/下找FishManager.java果然发现它定义了addFish(Fish fish)、removeFish(int id)、getFishById(int id)三个方法但updateAllFish()是default方法具体实现藏在FishManagerImpl.java里CFR 自动还原了默认方法体。这就是为什么不能只看单个类——必须把整个依赖链拉出来。2.2 补全缺失的资源与配置文件反编译只能还原代码但游戏运行离不开图片、音效、配置。原始包里没给images/或sounds/但ImageManager.class的反编译代码里明明白白写着public class ImageManager { private static final String[] FISH_IMAGE_PATHS { /images/fish_gold.png, // ID 0: 金鱼分值 100 /images/fish_shark.png, // ID 1: 鲨鱼分值 500带拖尾特效 /images/fish_jelly.png, // ID 2: 水母分值 30移动轨迹含随机抖动 /images/cannon_base.png, // 炮台底座 /images/cannon_barrel.png// 炮管旋转用 }; }这意味着资源路径是/images/xxx.png所以你要建src/main/resources/images/目录至少需要 5 类图片其中fish_shark.png必须带 alpha 通道因为代码里有g2.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, 0.7f));cannon_barrel.png尺寸必须是正方形代码中AffineTransform.getRotateInstance(angle, width/2, height/2)要求中心旋转。我从 CSDN 博文评论区扒到了作者当年上传的配套资源包链接见摘要解压后images/下正好有 12 张 PNG命名完全匹配FISH_IMAGE_PATHS数组。重点来了fish_jelly.png的抖动逻辑在Fish.java的move()方法里它不是简单x speed而是public void move() { // 基础位移 x speedX; y speedY; // 抖动每 8 帧触发一次幅度 ±3px仅对 jelly 有效 if (type FISH_JELLY frameCount % 8 0) { x (int)(Math.random() * 6 - 3); y (int)(Math.random() * 6 - 3); } frameCount; }你看连“抖动”这种细节都固化在代码里而不是靠配置表驱动。这就是经典 Java 游戏的典型做法性能优先配置让步。你要改抖动幅度直接改Math.random() * 6 - 3里的6。2.3 构建可运行的 Maven 工程现在代码有了资源有了下一步是让它在现代 JDK 上跑起来。别用 JDK 1.6 ——MainSurface.class里用了Override注解JDK 1.5 不支持且ScoreManager用了ConcurrentHashMapJDK 1.5 是ConcurrentHashMap但putIfAbsent是 JDK 1.6。我实测 JDK 11 是最稳的JDK 17 的 AWT 渲染有轻微撕裂JDK 8 的Thread.sleep(16)定时误差太大。pom.xml关键配置如下project xmlnshttp://maven.apache.org/POM/4.0.0 modelVersion4.0.0/modelVersion groupIdcom.fishing/groupId artifactIdfishing-darling/artifactId version1.0-SNAPSHOT/version properties maven.compiler.source11/maven.compiler.source maven.compiler.target11/maven.compiler.target /properties build resources resource directorysrc/main/resources/directory includes include**/*.png/include include**/*.wav/include /includes /resource /resources plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId version3.3.0/version configuration archive manifest mainClassMainSurface/mainClass !-- 注意入口是 MainSurface不是 Main -- addClasspathtrue/addClasspath /manifest /archive /configuration /plugin /plugins /build /project注意MainSurface是真正的启动类它继承JFrame并add(new LayoutManager())。很多教程误以为Main.java是入口但这个项目里根本没有Main.java——MainSurface就是主类。LayoutManager负责布局所有组件炮台、分数板、生命值LayoutManger.class反编译后能看到它用GridBagLayout精确控制每个 UI 元素的位置和缩放。执行mvn clean compile exec:java -Dexec.mainClassMainSurface如果看到窗口弹出、炮台可拖动、鱼开始游动恭喜你已经站在了可修改的起点上。3. 核心模块解析从单鱼行为到鱼群协同的三层状态机设计这个游戏的“智能感”不来自 AI而来自三层状态机的嵌套单条鱼的状态游动/受惊/被捕、鱼群的状态聚集/散开/转向、关卡的状态鱼种组合/刷新频率/背景流速。这三层不是平铺直叙而是通过ShoalManager和FishManager的协作完成解耦。下面拆解最关键的Fish状态流转和ShoalManager的集群逻辑。3.1 Fish 类的五态生命周期与事件驱动Fish.java定义了enum State { IDLE, MOVING, FRIGHTENED, CAPTURED, DEAD }但实际流转不是switch(state)硬编码而是由FishManager发布事件驱动// FishManager.java 片段 public void notifyCannonFired(double cannonX, double cannonY, double angle) { for (Fish fish : fishList) { double distance Math.sqrt(Math.pow(fish.x - cannonX, 2) Math.pow(fish.y - cannonY, 2)); if (distance 120.0) { // 炮弹有效半径 120px fish.onCannonNear(cannonX, cannonY, angle); // ← 事件注入点 } } } // Fish.java 中 onCannonNear 的实现 public void onCannonNear(double cx, double cy, double angle) { if (state State.MOVING || state State.IDLE) { state State.FRIGHTENED; // 计算逃跑方向垂直于炮口方向加 30 度随机偏移 double fleeAngle angle Math.PI/2 (Math.random() - 0.5) * Math.PI/3; speedX Math.cos(fleeAngle) * baseSpeed * 1.8; // 受惊速度提升 80% speedY Math.sin(fleeAngle) * baseSpeed * 1.8; fleeTimer 120; // 受惊持续 120 帧 ≈ 2 秒 } }这里的关键设计是鱼不主动“感知”炮台而是被动接收onCannonNear事件。这意味着你可以轻松扩展事件类型——比如增加onBombExplode(x,y,radius)让鱼在炸弹范围内统一进入FRIGHTENED状态而不用改每条鱼的run()循环。这就是面向对象里“依赖倒置”的实战体现FishManager依赖Fish接口Fish不依赖FishManager。3.2 ShoalManager 的鱼群协同算法基于距离阈值的局部平均鱼群不是靠中心节点指挥而是每条鱼观察周围 5 条最近的鱼计算平均位置和平均速度再微调自身运动。ShoalManager.updateShoals()的核心逻辑如下public void updateShoals() { for (Shoal shoal : shoals) { for (Fish fish : shoal.getMembers()) { // 1. 分离远离太近的邻居 30px Vector2d separation calculateSeparation(fish, shoal.getMembers(), 30.0); // 2. 对齐向邻居平均速度靠拢 Vector2d alignment calculateAlignment(fish, shoal.getMembers(), 100.0); // 3. 聚集向邻居平均位置靠拢 Vector2d cohesion calculateCohesion(fish, shoal.getMembers(), 100.0); // 合成最终加速度权重可配 fish.acceleration.x separation.x * 1.2 alignment.x * 0.8 cohesion.x * 0.5; fish.acceleration.y separation.y * 1.2 alignment.y * 0.8 cohesion.y * 0.5; } } }注意三个距离阈值分离用30.0对齐和聚集用100.0。这就是为什么鱼群看着“松散但不散开”——太近就推太远就拉中间区域保持动态平衡。calculateSeparation的实现不是简单取反向而是private Vector2d calculateSeparation(Fish target, ListFish members, double radius) { Vector2d steer new Vector2d(0, 0); int total 0; for (Fish other : members) { double d target.distanceTo(other); if (d radius d 0) { Vector2d diff new Vector2d(target.x - other.x, target.y - other.y); diff.normalize(); // 单位向量 diff.scale(1.0 / d); // 距离越近排斥力越大1/d steer.add(diff); total; } } if (total 0) steer.scale(1.0 / total); return steer; }看到没排斥力是1/d不是常量。这就是鱼群不会撞成一团的数学保证。如果你把radius改成10.0鱼群会瞬间炸开改成50.0它们会挤成一坨。参数即行为行为即体验。3.3 关卡系统用 XML 配置驱动难度曲线关卡数据不在代码里而在resources/levels/level1.xmllevel id1 name浅海区 duration180 !-- 180秒 -- fishes fish typegold count15 spawnInterval2000 / fish typejelly count8 spawnInterval3500 / /fishes background speed0.3 image/bg/shallow.png / scoreBonus multiplier1.0 / /levelLevelLoader.java解析此 XML并调用FishManager.spawnFish(type, count)。spawnInterval是毫秒级count是本关总生成数不是同时存在数——FishManager内部用ScheduledExecutorService按间隔 spawn。所以改关卡难度你根本不用碰 Java 代码改 XML 就行。level2.xml里shark的spawnInterval8000意味着平均每 8 秒刷一条鲨鱼玩家压力陡增。这就是配置驱动开发Configuration-Driven Development的教科书案例。4. 避坑指南那些让你调试到凌晨三点的 Java AWT/Swing 黑盒陷阱这个项目最大的坑不在逻辑而在 Java 图形栈的底层行为。我踩过 17 个坑挑最痛的 5 个写下来全是血泪经验不是网上抄的“常见问题”。4.1 现象鱼在窗口边缘“瞬移”或“卡住”明明x值在 0~800 之间画面却跳到 -100原因MainSurface使用BufferStrategy双缓冲但LayoutManager.paintComponent(Graphics g)里调用了g.translate(-scrollX, -scrollY)做视口偏移而Fish.draw(Graphics2D g)里又做了g.translate(fish.x, fish.y)。当鱼靠近右下角时两次 translate 叠加导致坐标溢出整型范围int最大 2147483647Java2D 自动截断为负数。解决在Fish.draw()开头加坐标钳制public void draw(Graphics2D g) { // 钳制坐标防止 translate 溢出 int drawX (int)Math.max(0, Math.min(Short.MAX_VALUE, x)); int drawY (int)Math.max(0, Math.min(Short.MAX_VALUE, y)); g.translate(drawX, drawY); // ... 后续绘制 }4.2 现象炮台旋转时出现严重锯齿放大看边缘全是马赛克原因CannonManager的drawBarrel()方法里Graphics2D.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_OFF)被硬编码关闭了抗锯齿。这是为了老机器性能但在现代显示器上就是灾难。解决注释掉那行改为g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); g2.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);4.3 现象多线程下ScoreManager.addScore()有时不生效分数卡在 9999 不动原因ScoreManager用int score存储但addScore(int delta)方法没有synchronized而FishRunThread和CannonManager会并发调用。更致命的是score delta在字节码层面是iload_0,iload_1,iadd,istore_0四步非原子操作。解决将int score改为AtomicInteger score new AtomicInteger(0)addScore改为public void addScore(int delta) { score.addAndGet(delta); // 原子操作 }注意ScoreManager的getScore()也要用score.get()不能直接返回score字段。4.4 现象切换关卡后新关卡的鱼全部堆在左上角 (0,0)不动原因ShoalManager.clearShoals()只清空了shoals列表但FishManager.fishList里的鱼对象state仍是CAPTURED或DEADspawnFish()新建的鱼被FishRunThread.updateAllFish()跳过因为state ! MOVING。解决在LevelLoader.loadLevel()末尾强制重置所有鱼状态for (Fish fish : fishManager.getAllFish()) { if (fish.getState() Fish.State.CAPTURED || fish.getState() Fish.State.DEAD) { fish.resetToIdle(); // Fish.java 中新增 resetToIdle() 方法 } }4.5 现象JDK 11 运行时抛java.awt.HeadlessException窗口打不开原因MainSurface构造函数里GraphicsEnvironment.getLocalGraphicsEnvironment().getDefaultScreenDevice()在无头服务器环境失败但代码没做 fallback。解决在MainSurface构造函数开头加检测if (GraphicsEnvironment.isHeadless()) { throw new RuntimeException(This game requires a graphical display environment); }并在启动脚本里确保DISPLAY环境变量正确Linux/macOS或不屏蔽 GUIWindows。5. 进阶技巧把 Java 捕鱼达人升级成可配置、可监控、可热更的现代桌面应用现在你已经能跑、能调、能改基础逻辑。但真实项目要走得更远——比如让策划同学不改代码就能调鱼的分值让运维能看实时帧率让更新不用重启。下面三个技巧是我从这个项目里提炼出的、可直接复用的工程化方案。5.1 用 Properties 文件替代硬编码参数实现“零代码”调参Fish.java里baseSpeed、scoreValue、fleeTimer全是常量改一次编译一次。把它抽成config/fish.properties# config/fish.properties gold.baseSpeed1.2 gold.scoreValue100 gold.fleeTimer120 shark.baseSpeed0.8 shark.scoreValue500 shark.fleeTimer200 jelly.baseSpeed0.6 jelly.scoreValue30 jelly.fleeTimer80FishFactory.java新增类负责加载public class FishFactory { private static final Properties props new Properties(); static { try (InputStream is FishFactory.class.getClassLoader() .getResourceAsStream(config/fish.properties)) { props.load(is); } catch (IOException e) { throw new RuntimeException(Failed to load fish config, e); } } public static Fish createFish(int type) { Fish fish new Fish(type); fish.baseSpeed Double.parseDouble(props.getProperty( getPropKey(type) .baseSpeed, 1.0)); fish.scoreValue Integer.parseInt(props.getProperty( getPropKey(type) .scoreValue, 10)); fish.fleeTimer Integer.parseInt(props.getProperty( getPropKey(type) .fleeTimer, 100)); return fish; } private static String getPropKey(int type) { return switch (type) { case FISH_GOLD - gold; case FISH_SHARK - shark; case FISH_JELLY - jelly; default - gold; }; } }提示Properties加载路径是classpath:/config/fish.properties所以要把config/目录放在src/main/resources/下。改完属性文件重启应用即可生效策划再也不用求你改代码。5.2 嵌入实时性能监控面板用 JMX 暴露关键指标FishRunThread的run()方法里每秒统计一次帧率、鱼数量、线程状态通过 JMX 暴露// 在 FishRunThread 构造函数里注册 MBean private final FishingStatsMBean stats new FishingStats(); private final MBeanServer mbs ManagementFactory.getPlatformMBeanServer(); public FishRunThread(...) { try { ObjectName name new ObjectName(com.fishing:typeFishingStats); mbs.registerMBean(stats, name); } catch (Exception e) { e.printStackTrace(); } } // FishingStats.java public class FishingStats implements FishingStatsMBean { private long frameCount 0; private long lastReset System.currentTimeMillis(); private int currentFishCount 0; Override public double getFps() { long now System.currentTimeMillis(); if (now - lastReset 1000) { fps (double) frameCount / ((now - lastReset) / 1000.0); frameCount 0; lastReset now; } return fps; } Override public int getCurrentFishCount() { return currentFishCount; } // ... getter/setter }启动应用后用jconsole连接进程在MBeans标签页找到com.fishing → FishingStats就能实时看Fps和CurrentFishCount。这是排查卡顿的第一现场。5.3 实现资源热更新图片/音效不重启即时生效ImageManager当前是静态加载改图就得重启。改成监听文件变化public class ImageManager { private static final MapString, BufferedImage cache new ConcurrentHashMap(); private static final WatchService watcher; static { try { watcher FileSystems.getDefault().newWatchService(); Path imagesPath Paths.get(src/main/resources/images/); imagesPath.register(watcher, StandardWatchEventKinds.ENTRY_MODIFY, StandardWatchEventKinds.ENTRY_CREATE); // 启动监听线程 new Thread(() - { while (true) { WatchKey key; try { key watcher.take(); } catch (InterruptedException e) { return; } for (WatchEvent? event : key.pollEvents()) { Path filename (Path) event.context(); String fullPath imagesPath.resolve(filename).toString(); if (fullPath.endsWith(.png)) { cache.remove(filename.toString()); System.out.println(Hot reloaded: filename); } } key.reset(); } }).start(); } catch (IOException e) { e.printStackTrace(); } } public static BufferedImage getImage(String path) { return cache.computeIfAbsent(path, p - { try { return ImageIO.read(ImageManager.class.getResource(p)); } catch (IOException e) { throw new RuntimeException(e); } }); } }注意src/main/resources/images/必须是绝对路径且 IDE 要设置 “Build → Automatically compile on save”。改完fish_shark.png保存3 秒内游戏里鲨鱼就变新图——这才是真正的热更。从那以后我每次做 Java 桌面游戏都强制走一遍这三步参数外置、指标暴露、资源热更。不是为了炫技是让需求变更的成本从“改代码→编译→发版→重启”压缩到“改配置→保存→刷新”。希望帮到你。本文还有配套的精品资源点击获取
