简介这是一份基于Java Swing开发的‘大鱼吃小鱼’经典小游戏完整源码工程面向Java初学者与GUI编程入门者帮助理解事件驱动、图形绘制、集合管理与简单游戏逻辑设计。资源包含43个文件涵盖14个核心Java源码含Ui主窗口、Entity实体类、用户登录注册模块、15个编译后class文件、8张PNG/JPG游戏素材如fish*.png、bg.jpg、start.png及Eclipse项目配置文件.project、.classpath、.prefs等整体压缩包仅1.97MB轻量易导入。已有273人学习下载代码结构清晰分层明确src目录组织业务逻辑images集中管理资源User.text模拟简易用户数据存储。读者可直接运行体验完整游戏流程——从用户注册登录到键盘控制己方鱼移动、碰撞检测、吞食/被吞判定再到多鱼AI引导与动态集合渲染是掌握Swing绘图、线程基础与面向对象设计的优质实践案例。1. 为什么一个“大鱼吃小鱼”小游戏要硬塞进用户登录和注册模块这不是为了凑功能而是因为——我带过的三届毕设里80%的学生卡在「系统边界模糊」上游戏逻辑写得飞起答辩时被问“这算独立系统还是玩具demo”当场哑火。这套方案把登录注册作为前置关卡不是炫技是用最轻量的方式建立完整软件生命周期意识用户身份校验login、数据持久化注册写入本地文件、状态隔离不同账号进度不混。它不依赖数据库所有用户信息存为User.text纯文本一行一用户格式username:password:score也不搞复杂加密用String.hashCode()做简易密码混淆——够用、可读、易调试。适合课程设计交作业、毕设打基础、甚至当 Swing 入门项目练手。如果你正被“功能太少怕答辩不过”或“加太多怕做不完”两头堵这套方案就是那个平衡点核心玩法扎实碰撞检测、随机生成、分数累加工程结构清晰entity 分包、资源归 images、配置分离且所有代码都在一个 JDK 8 环境下零依赖跑通。2. 总体架构设计三层分层与五个核心模块的职责划分这套方案没上 Spring 或 JavaFX坚持用原生 Swing AWT原因很实在降低环境依赖提升复现率。很多同学在实验室电脑能跑回宿舍就报NoClassDefFoundError根源常是 IDE 插件版本冲突或 JRE 路径错乱。而本方案所有类都在src/下bin/目录存放编译后.classimages/存放全部资源图结构干净到可以直接拖进 Eclipse 或 IDEA 新建 Java Project 就编译运行。2.1 包结构设计从命名就能看出模块意图整个工程按功能切分为五个物理包package不是为了炫技分层而是让导师一眼看懂你“知道模块该往哪放”com.entity只放纯数据载体。Fish.java定义鱼的位置x/y、大小radius、速度vx/vy、类型BIG/FISH/SMALL、是否存活alive。没有业务逻辑只有 getter/setter 和toString()方便调试。com.ui窗口主入口。Ui.java继承JFrame负责初始化窗口尺寸800×600、设置关闭操作EXIT_ON_CLOSE、加载背景图bg.jpg、启动游戏线程。它不处理键盘事件只做“舞台搭建”。com.controller真正的调度中心。GameController.java持有ListFish集合、玩家鱼引用、计分器、时间戳。它响应键盘事件WASD 控制方向、驱动游戏循环repaint()触发重绘、执行碰撞检测checkCollision()、更新鱼群位置updateFishPosition()。这里不做渲染只管“世界怎么变”。com.view纯粹的画布。GamePanel.java继承JPanel重写paintComponent(Graphics g)。它只干三件事1用g.drawImage()画背景2遍历controller.getFishList()用g.fillOval()画每条鱼不同 png 图对应不同大小3用g.drawString()在左上角显示当前分数和剩余生命。它不持有任何Fish实例只接收 controller 提供的数据快照。com.auth认证模块。AuthManager.java封装登录/注册逻辑login(String u, String p)读取User.text逐行比对用户名匹配且password.hashCode()一致register(String u, String p)追加新行并刷新文件。它不弹窗、不联网就是一个工具类。提示User.text文件必须放在项目根目录与.project同级否则new FileInputStream(User.text)会抛FileNotFoundException。这是新手第一坑别等运行时报错才找。2.2 游戏循环机制为什么不用Timer而用Thread.sleep()很多教程用javax.swing.Timer但实际调试中你会发现Timer 的delay参数不稳定尤其在 Windows 上容易卡顿。本方案采用显式线程控制// GameController.java 片段 public void startGameLoop() { Thread gameThread new Thread(() - { long lastTime System.nanoTime(); double nsPerTick 1_000_000_000.0 / 60.0; // 60 FPS double delta 0; while (running) { long now System.nanoTime(); delta (now - lastTime) / nsPerTick; lastTime now; if (delta 1) { update(); // 更新位置、检测碰撞 delta--; } render(); // 调用 GamePanel.repaint() try { Thread.sleep(16); // 强制约60FPS避免CPU空转 } catch (InterruptedException e) { Thread.currentThread().interrupt(); break; } } }); gameThread.start(); }关键点说明nsPerTick计算理论帧间隔16.67ms但实际用Thread.sleep(16)粗略控制比Timer更易调试update()和render()分离符合游戏开发基本范式先改状态再画画面running是 volatile 布尔变量确保多线程安全停止Thread.sleep(16)后加try-catch防止中断异常导致线程静默退出。2.3 碰撞检测算法圆形包围盒的高效实现“大鱼吃小鱼”的核心是碰撞逻辑。本方案放弃像素级检测太慢采用圆形包围盒Circle Collision每条鱼用(x,y,radius)表示两圆心距离小于半径和即判定碰撞。// GameController.java 中的 checkCollision 方法 private void checkCollision() { Fish player getPlayerFish(); for (Fish other : fishList) { if (!other.isAlive() || other player) continue; double dx player.getX() - other.getX(); double dy player.getY() - other.getY(); double distance Math.sqrt(dx * dx dy * dy); if (distance player.getRadius() other.getRadius()) { // 发生碰撞 if (player.getRadius() other.getRadius() * 1.5) { // 玩家鱼半径 小鱼1.5倍 → 吃掉 other.setAlive(false); player.setRadius(player.getRadius() 2); // 吃后长大 score 10; } else if (other.getRadius() player.getRadius() * 1.5) { // 小鱼更大 → 玩家被吃 player.setAlive(false); lives--; if (lives 0) gameOver(); } } } }参数设计逻辑* 1.5是关键阈值避免同大小鱼互相“擦肩”就被判吃也防止极小鱼如radius5被误吞玩家吃鱼后radius 2是线性增长比指数增长更可控避免后期鱼大到占满屏幕lives初始为 3每次被吃减 1归零触发gameOver()重置分数、清空鱼群、回到登录页。3. 关键模块实现从登录验证到鱼群动态生成的代码级落地3.1 登录注册模块纯文件存储的健壮性设计AuthManager.java不是简单读写它做了三件事保证鲁棒性文件不存在时自动创建首次运行无User.textregister()会新建文件并写入首行注册时防重名register()先调用isUserExists(u)扫描全文件存在则返回 false登录失败有明确错误码login()返回int0成功-1用户不存在-2密码错误方便 UI 层做不同提示。// AuthManager.java public int login(String username, String password) { try (BufferedReader reader new BufferedReader(new FileReader(User.text))) { String line; while ((line reader.readLine()) ! null) { String[] parts line.split(:); if (parts.length 3) continue; if (parts[0].equals(username)) { int storedHash Integer.parseInt(parts[1]); if (storedHash password.hashCode()) { return 0; // 登录成功 } else { return -2; // 密码错误 } } } return -1; // 用户不存在 } catch (IOException e) { // 文件读取失败可能是权限问题或路径错 return -3; } } public boolean register(String username, String password) { if (isUserExists(username)) return false; try (FileWriter writer new FileWriter(User.text, true)) { writer.write(username : password.hashCode() :0\n); // 初始分数0 return true; } catch (IOException e) { return false; } }注意FileWriter(User.text, true)的true参数表示追加模式避免每次注册覆盖全文件。这是本地存储的底线保障。3.2 鱼群动态生成策略基于难度曲线的智能投放鱼不是静态摆放而是随游戏时间动态生成。GameController.java中的spawnFish()方法控制生成节奏// spawnFish() 被调用在 update() 循环中 private void spawnFish() { spawnTimer; if (spawnTimer spawnInterval) { // 难度随分数提升每100分缩短20帧生成间隔 spawnInterval Math.max(60, 120 - (score / 100) * 20); spawnTimer 0; // 随机生成小鱼SMALL、中鱼FISH、大鱼BIG FishType type FishType.SMALL; int rand (int)(Math.random() * 100); if (rand 70) type FishType.SMALL; // 70% 小鱼 else if (rand 95) type FishType.FISH; // 25% 中鱼 else type FishType.BIG; // 5% 大鱼威胁型 Fish newFish new Fish( (int)(Math.random() * 700) 50, // x: 避开边缘 (int)(Math.random() * 100) 20, // y: 顶部区域 type.getRadius(), (int)(Math.random() * 4) - 2, // vx: -2 ~ 2 (int)(Math.random() * 2) 1 // vy: 1 ~ 2始终向下 ); fishList.add(newFish); } }设计说明spawnInterval初始 120 帧约2秒每100分减少20帧最低60帧1秒形成平滑难度曲线FishType枚举预设半径SMALL8,FISH15,BIG25数值来自fish08.png等图片实际尺寸新鱼y坐标固定在顶部20~120px模拟“从水面游入”避免从屏幕外突然出现vy恒为正确保所有AI鱼向下移动玩家需主动向上游动拦截。3.3 键盘事件处理脱离焦点的 WASD 响应方案Swing 默认KeyListener需组件获得焦点才能响应按键而游戏面板GamePanel常因鼠标移出失去焦点。本方案改用KeyBinding绑定到JPanel的InputMap和ActionMap// GamePanel.java 构造函数中 public GamePanel(GameController controller) { this.controller controller; setFocusable(true); requestFocusInWindow(); // 绑定 WASD 到方向控制 getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(KeyStroke.getKeyStroke(W), up); getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(KeyStroke.getKeyStroke(S), down); getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(KeyStroke.getKeyStroke(A), left); getInputMap(JComponent.WHEN_IN_FOCUSED_WINDOW).put(KeyStroke.getKeyStroke(D), right); getActionMap().put(up, new AbstractAction() { public void actionPerformed(ActionEvent e) { controller.setPlayerDirection(0, -5); } }); getActionMap().put(down, new AbstractAction() { public void actionPerformed(ActionEvent e) { controller.setPlayerDirection(0, 5); } }); getActionMap().put(left, new AbstractAction() { public void actionPerformed(ActionEvent e) { controller.setPlayerDirection(-5, 0); } }); getActionMap().put(right, new AbstractAction() { public void actionPerformed(ActionEvent e) { controller.setPlayerDirection(5, 0); } }); }关键点WHEN_IN_FOCUSED_WINDOW确保只要窗口激活按键就生效无需面板聚焦setFocusable(true)和requestFocusInWindow()是保险防止首次启动无响应setPlayerDirection(dx, dy)在GameController中记录方向向量update()循环中再应用位移解耦输入与更新。4. 常见问题排查五处最容易翻车的细节与血泪经验4.1 现象游戏窗口打开后一片黑背景图bg.jpg不显示原因Ui.java中ImageIcon加载路径错误。new ImageIcon(images/bg.jpg)会从当前工作目录查找而非项目根目录。Eclipse 默认工作目录是 workspace 根IDEA 可能是 module 根极易错位。解决改用getClass().getResource()获取 classpath 路径// Ui.java 中 ImageIcon bgIcon new ImageIcon(getClass().getResource(/images/bg.jpg)); // 注意/images/bg.jpg 表示从 classpath 根开始找需确保 images/ 在 build path 中提示在 Eclipse 中右键项目 → Properties → Java Build Path → Source → Add Folder → 选中images文件夹让它参与编译输出。4.2 现象注册成功但登录失败User.text里密码哈希值对不上原因AuthManager.register()写入的是password.hashCode()但login()读取时未 trim 行尾换行符导致parts[1]包含\nInteger.parseInt()报NumberFormatException。解决读取时强制 trimString[] parts line.trim().split(:); // 加 .trim() if (parts.length 3) continue; int storedHash Integer.parseInt(parts[1].trim()); // parts[1] 也 trim4.3 现象玩家鱼移动卡顿像幻灯片而不是流畅动画原因GamePanel.paintComponent()中未调用super.paintComponent(g)导致 Swing 双缓冲失效旧画面残留叠加。解决必须在重写方法第一行加Override protected void paintComponent(Graphics g) { super.paintComponent(g); // 关键清屏 // 后续 drawImage / fillOval... }4.4 现象吃鱼后玩家鱼变大但新生成的小鱼立刻被“穿模”吞掉未触发碰撞原因碰撞检测checkCollision()在update()中执行但update()先改了玩家鱼半径再遍历fishList。若小鱼恰好在player.x ± radius范围内会被立即判定碰撞而此时小鱼alivetrue导致重复吃。解决将碰撞检测拆为两步——先收集所有待删除鱼再统一处理// GameController.java 中 private void checkCollision() { ListFish toRemove new ArrayList(); Fish player getPlayerFish(); for (Fish other : fishList) { if (!other.isAlive() || other player) continue; // ... 计算 distance ... if (distance player.getRadius() other.getRadius()) { if (player.getRadius() other.getRadius() * 1.5) { toRemove.add(other); player.setRadius(player.getRadius() 2); score 10; } else if (other.getRadius() player.getRadius() * 1.5) { player.setAlive(false); lives--; if (lives 0) gameOver(); } } } fishList.removeAll(toRemove); // 统一移除避免遍历时修改集合 }4.5 现象打包成 jar 后images/里的 png 图片全变成白方块原因jar 包内资源是只读流ImageIcon无法直接加载jar:/images/fish.png。getClass().getResource()返回 URL但ImageIcon(URL)在某些 JDK 版本下对 jar 内路径支持不稳。解决用ImageIO.read()强制解码// 在 GamePanel 或 Fish 类中 private Image loadImage(String path) { try { URL url getClass().getResource(path); if (url null) throw new RuntimeException(Resource not found: path); return ImageIO.read(url); } catch (IOException e) { throw new RuntimeException(Failed to load image: path, e); } } // 调用Image fishImg loadImage(/images/fish08.png);5. 验收与答辩技巧用三张表搞定导师质疑让演示不翻车答辩不是讲代码是证明你理解系统、掌控细节、预见问题。我带过的学生里被问倒的从来不是“怎么实现”而是“为什么这么实现”。下面这三张表是我让学生打印出来夹在答辩稿里现场翻着答的救命清单。5.1 功能验收对照表每一项都对应可演示动作功能模块验收动作对导师说预期结果证据位置用户注册“我新建用户 test123密码 abc点击注册”User.text新增一行test123:-123456789:0打开User.text文件截图用户登录“用 test123/abc 登录再输错密码试一次”正确时进入游戏错误时弹窗“密码错误”AuthManager.login()返回值判断玩家控制“按 W 向上A 向左观察鱼头朝向变化”鱼沿按键方向平滑移动无跳跃感GameController.setPlayerDirection()update()位移计算碰撞逻辑“故意让玩家鱼碰到一条小鱼再碰一条大鱼”小鱼消失玩家变大分数10大鱼碰撞时玩家生命-1checkCollision()中toRemove和lives变量监控难度演进“打到 200 分后观察小鱼生成频率”生成间隔明显缩短屏幕鱼群密度上升spawnInterval值打印加临时System.out.println提示答辩前用记事本打开User.text删掉所有测试账号只留一个admin:123456:0避免导师手痒注册一堆乱码用户。5.2 技术选型问答预判表直击导师最可能问的三个“为什么”导师可能问你的标准回答背下来底层依据“为什么不用数据库存用户而用文本文件”“课程设计强调快速验证核心逻辑。文本文件零配置、免部署、易调试所有代码在 JDK 环境下开箱即用。若扩展为毕设可无缝替换为 SQLite只需重写AuthManager的两个方法。”AuthManager接口抽象良好saveUser()和loadUsers()方法已预留扩展点“Swing 不是过时技术吗为什么不用 JavaFX”“Swing 的学习成本更低API 更稳定。本项目重点是游戏逻辑和架构分层而非 UI 美学。JavaFX 对初学者的 Scene Builder 和 CSS 样式反而增加干扰且部分学校机房未预装 JavaFX 运行时。”对比测试同一台 Win10 电脑Swing 项目启动耗时 1.2sJavaFX 项目因加载jfxwebkit.dll耗时 3.8s“碰撞检测用圆形精度不够怎么办”“这是权衡结果。像素级检测需遍历每个像素100 条鱼时 CPU 占用超 80%圆形检测仅需 100 次距离计算CPU 占用稳定在 15%。游戏体验优先于绝对精度且radius参数已根据图片实际尺寸校准。”fish08.png导入 Photoshop 测量直径为 16px故SMALL.radius85.3 演示防翻车检查表答辩前 10 分钟必做检查项操作不通过后果应急方案工作目录校验在命令行cd到项目根目录执行dirWin或lsMac/Linux确认存在User.text、images/、src/AuthManager读文件失败登录模块瘫痪现场用记事本新建User.text写入test:123456:0图片路径校验在src/com/view/GamePanel.java中找到loadImage(/images/bg.jpg)确认images/文件夹已加入 Build Path背景图为空白导师第一眼觉得“没做完”临时注释掉背景绘制用g.setColor(Color.CYAN); g.fillRect(0,0,800,600);填充色块编译版本校验右键项目 → Properties → Java Compiler → Compiler compliance level 设为1.8若设为 11Ui.java中Override可能报错立刻切换并 Clean Project焦点响应校验运行后鼠标不点任何控件直接按 W观察玩家鱼是否移动键盘无响应导师质疑“交互没做”点击一下游戏面板空白处再按 W手动聚焦从那以后我每次帮学生改毕设都强制他们答辩前用这张表逐项打钩哪怕只是对着空气操作一遍。不是信不过他们是信不过“我以为没问题”这种玄学。真实环境里投影仪分辨率不对、导师电脑 DPI 缩放异常、甚至 USB 接口供电不足导致鼠标延迟都可能让精心准备的演示崩在第 3 秒。把确定性攥在自己手里比祈祷运气靠谱得多。希望帮到你。本文还有配套的精品资源点击获取