简介这份资源是面向Java初学者与游戏开发入门者的「大鱼吃小鱼」完整项目源码包围绕JFrame与JPanel搭建游戏窗口、鼠标事件监听驱动大鱼跟随、Graphics绘图与Timer重绘实现动画、游戏状态管理与图片资源加载等核心环节展开可帮助读者理解Swing图形界面与游戏循环的基本设计思路。压缩包共1171个文件以715张png、27个gif、20张jpg等图片素材为主辅以java源码、class字节码、xml与properties配置及工程元数据文件整体约61.41MB目录结构清晰便于按模块查阅。目前已有1454人学习下载。代码注释详尽、结构分层明确读者可据此复现完整游戏流程并借助继承与多态机制扩展鱼种、障碍物与关卡设计适合作为课程设计或二次开发的实践底稿。1. 从一份 Java 大鱼吃小鱼源码包说起JFrame 与 JPanel 到底怎么分工很多人第一次拿到「java大鱼吃小鱼.zip」这类资源第一反应是双击解压、找 main 方法、直接跑起来看效果结果要么窗口一片空白要么鱼不动、键盘没反应最后怀疑代码是坏的。其实这类基于 JFrame JPanel 的 Java 小游戏跑不起来十有八九不是代码问题而是资源路径、线程刷新和事件焦点三件事没对齐。这份源码包是一个完整的桌面端「大鱼吃小鱼」小游戏实现用 Swing 做窗口与画布用定时器或独立线程驱动游戏循环涵盖玩家鱼移动、敌方鱼生成、碰撞检测、吃小鱼变大、被大鱼吃掉结束等核心玩法。它适合两类人一是刚学完 Java 基础、想找一个能跑通、能改得动的小项目练手的开发者二是需要一份可直接拆解的游戏循环与碰撞逻辑参考实现、拿去做课程设计或二次开发的老手。下面按「先看懂结构、再动手跑通、最后改出自己想要的效果」的顺序拆。2. 拆开压缩包先看骨架JFrame 与 JPanel 的职责边界2.1 窗口层与画布层为什么必须分开Swing 里 JFrame 是顶层容器负责窗口标题、边框、关闭行为、尺寸这些「壳」的事情JPanel 是画布负责在paintComponent里把鱼、背景、分数画出来。这份源码把两者分开是符合 Swing 惯例的做法也是新手最容易搞混的地方。常见错误是把游戏循环、键盘监听、绘制逻辑全塞进 JFrame 子类里短期能跑但一旦要加暂停、重开、多面板切换就会乱成一团。正确的分层是JFrame 只做setContentPane、setVisible、setDefaultCloseOperation这类窗口配置JPanel 子类持有游戏状态玩家鱼坐标、敌鱼列表、分数、是否结束并在paintComponent(Graphics g)里统一绘制。这样你改玩法只动面板改窗口外观只动框架互不干扰。判断一份源码分层是否干净有个简单办法看 JPanel 子类里有没有new JFrame()。如果有说明耦合了后面加菜单栏或换皮肤会很难受。这份包里的结构相对规整面板类不依赖窗口类可以单独塞进别的容器里测试。2.2 游戏循环Timer 还是 Thread选哪个Swing 桌面小游戏的刷新有两条常见路线javax.swing.Timer和独立Thread。前者回调在事件分发线程EDT上执行天然线程安全适合逻辑简单、每帧计算量小的场景后者需要自己处理Thread.sleep和repaint的线程安全问题但帧率控制更自由。这份源码用的是定时器驱动 repaint()的经典组合逻辑大致如下// 游戏主面板中的定时器初始化常见写法 private Timer gameTimer; public GamePanel() { // 16ms 约等于 60 帧实际受机器性能影响 gameTimer new Timer(16, e - { updateGame(); // 更新鱼的位置、碰撞、分数 repaint(); // 请求重绘Swing 会合并多次请求 }); gameTimer.start(); } private void updateGame() { // 玩家鱼根据按键状态移动 // 敌鱼按各自速度前进越界后回收或重新生成 // 检测玩家与敌鱼的矩形/圆形碰撞 }Timer的第一个参数是毫秒间隔16 对应约 60 FPS但 Swing 的定时器不保证精确机器卡顿时会丢帧所以游戏里所有位移都要写成「速度 × 时间增量」或至少用固定步长不能假设每帧间隔绝对相等。updateGame()里只改数据、不直接画repaint()只是发出重绘请求真正的绘制发生在 EDT 调度的paintComponent中。这个「数据更新与绘制分离」的习惯是后面加暂停、加特效时不翻车的前提。2.3 键盘输入为什么经常「没反应」新手跑这类游戏最常见的抱怨是「按方向键鱼不动」。原因通常不是监听没写而是焦点问题JPanel 默认不一定能获得键盘焦点KeyListener只在组件持有焦点时才触发。稳妥做法是给面板setFocusable(true)并requestFocusInWindow()或者干脆用 Key BindingsgetInputMapgetActionMap把按键映射成动作后者不依赖焦点、还能避免按键重复触发的玄学问题。源码里如果用的是 KeyListener跑之前先点一下游戏窗口再按键往往就「活」了——这不是代码错是焦点没给到。3. 把项目跑起来环境、编译与资源路径三件事3.1 JDK 版本与编译命令这类 Swing 项目对 JDK 版本不挑JDK 8 到 17 基本都能编译但要注意源码里有没有用到高版本语法如var、switch表达式。拿到包后先看目录里有没有.classpath、pom.xml或build.gradle有 Maven/Gradle 配置就按构建工具走没有就是纯源码手动编译。纯源码的典型结构是src/下按包名分目录入口类带main方法。编译与运行命令如下# 在源码根目录执行-d 指定输出目录避免污染源码 javac -encoding UTF-8 -d out $(find src -name *.java) # 运行注意把包名换成实际的入口类全限定名 java -cp out com.example.fish.GameMain-encoding UTF-8不能省中文注释或字符串在 GBK 默认环境下会编译报错或乱码。find在 Windows 的 cmd 里不可用可以改用dir /s /b src\*.java sources.txt再javac sources.txt。如果源码里图片、音频是用相对路径加载的比如ImageIO.read(new File(res/fish.png))运行时的工作目录必须是资源所在目录否则就是经典的NullPointerException或空图。更稳的写法是把资源打进 classpath用getClass().getResource(/res/fish.png)读取这样无论从哪个目录启动都能找到。3.2 资源加载的两种写法与踩坑对照加载方式写法适用场景常见问题文件系统路径new File(res/fish.png)本地调试、资源目录固定换工作目录就找不到打包成 jar 后失效classpath 资源getClass().getResource(/res/fish.png)正式运行、打包分发路径前导斜杠写错会返回 null如果源码用的是第一种而你从 IDE 里直接 Run 能跑、命令行跑就白屏八成就是工作目录不一致。解决办法二选一要么在命令行里先cd到资源目录再启动要么把加载代码改成 classpath 方式。改的时候注意getResource返回的是 URLImageIO.read可以直接吃 URL但null检查一定要加否则资源缺失时抛的是空指针排查起来很费时间。3.3 打包成可双击运行的 jar想脱离 IDE 演示打包是绕不开的一步。带资源文件的 jar 需要把res/一起打进去并在 manifest 里指定入口类# 先编译到 out再把资源和 class 一起打包 jar -cfe FishGame.jar com.example.fish.GameMain -C out . -C res .-cfe依次是创建、指定入口类、指定 jar 名后面的-C 目录 .表示把该目录内容打进 jar 根。打包后双击运行如果报「找不到主类」检查 manifest 里的类名是否带完整包名如果图片不显示说明资源路径还是文件系统写法需要改成 classpath 读取。这一步是很多人卡住的地方血泪经验是先在命令行用java -jar跑通再谈双击别一上来就双击然后对着闪退窗口猜。4. 改玩法前先改对参数速度、碰撞与生成逻辑4.1 移动速度与帧率的关系游戏里鱼的移动通常写成x speed这个speed是「每帧像素数」。在 60 FPS 下speed 3意味着每秒移动 180 像素看起来正常但如果机器掉到 30 FPS同样的speed就变成每秒 90 像素鱼会明显变慢。想让手感稳定要么把速度改成「像素/秒」再乘以帧间隔要么接受固定步长并在卡顿时容忍轻微变速。小游戏一般选后者简单够用。调参时建议把玩家鱼速度、敌鱼速度、敌鱼生成间隔做成常量或配置集中放在一个类里改起来不用满文件搜数字。4.2 碰撞检测矩形够不够用这类游戏九成用矩形包围盒做碰撞给每条鱼一个Rectangle用intersects判断。优点是快、代码短缺点是鱼是椭圆或带透明边矩形会比视觉范围大一圈出现「明明没碰到就死了」的憋屈感。改进办法有两种一是把碰撞矩形按鱼的实际身体缩小一圈比如宽高各乘 0.7二是用圆形距离判断Math.hypot(dx, dy) r1 r2对圆形鱼更贴合。改的时候注意玩家鱼吃小鱼和碰大鱼的判定要分开写别用一个intersects通吃否则「吃」和「被吃」的边界会打架。// 缩小包围盒的碰撞判定减少误判 Rectangle playerBox new Rectangle( player.getX() player.getWidth() / 6, player.getY() player.getHeight() / 6, player.getWidth() * 2 / 3, player.getHeight() * 2 / 3 ); for (EnemyFish e : enemies) { if (playerBox.intersects(e.getBounds())) { if (player.getSize() e.getSize()) { player.grow(); // 吃小鱼变大 e.markDead(); // 标记移除别在遍历中直接删 } else { gameOver true; // 被大鱼吃掉 } } }这里有个容易翻车的点在for循环里直接enemies.remove(e)会抛ConcurrentModificationException。稳妥做法是标记死亡、循环结束后统一清理或者用迭代器的remove。另外grow()之后玩家鱼的包围盒会变大下一帧的碰撞判定要基于新尺寸别缓存旧矩形。4.3 敌鱼生成随机不等于乱来敌鱼生成一般用随机数决定出现位置和大小但纯随机会导致两个问题一是大鱼小鱼比例失衡玩家要么吃不到、要么一出生就被秒二是生成位置可能正好压在玩家身上开局即结束。常见做法是给生成加约束新鱼从屏幕边缘外进入大小按玩家当前体型做区间浮动保证既有能吃的也有要躲的。生成间隔随分数或时间递减难度曲线才立得住。这些参数没有标准答案改完自己玩两分钟手感对了就是对了。5. 避坑与排查跑不动、画不出、越玩越卡5.1 窗口出来了但画面全白现象程序启动窗口正常但画布一片白鱼和背景都不显示。原因通常是paintComponent没被正确重写或者重写时忘了调super.paintComponent(g)导致背景没清、绘制被覆盖也可能是资源图片加载返回nulldrawImage静默失败。解决先确认方法签名是protected void paintComponent(Graphics g)且第一行调了父类方法再在图片加载处打印或断言非空把null挡在绘制之前。5.2 按键没反应或鱼一直往一个方向跑现象按方向键鱼不动或者松开键后鱼还在飘。原因一是焦点没给到面板二是用 KeyListener 时只处理了keyPressed没处理keyReleased导致按键状态没复位。解决面板setFocusable(true)并请求焦点或改用 Key Bindings移动逻辑用「按下置 true、松开置 false」的布尔状态在updateGame里根据状态算位移而不是在按键回调里直接改坐标。5.3 玩一会儿越来越卡现象刚开始流畅鱼越生成越多后明显掉帧。原因通常是死亡或越界的鱼只从画面移除、没从集合里删列表无限增长每帧遍历和绘制量越来越大。解决在更新阶段统一清理标记死亡的敌鱼并给敌鱼数量设上限超出时回收最老的。顺带检查有没有在paintComponent里new图片或字体绘制方法里创建对象是性能大忌。5.4 打包后能启动但没声音没图现象IDE 里一切正常打成 jar 后资源全丢。原因就是前面说的文件系统路径加载jar 内没有「工作目录」概念。解决全部改成getClass().getResource方式路径用 jar 内绝对路径以/开头并确认打包命令把资源目录带进去了。5.5 中文显示成方块现象分数、提示文字里的中文变成方框。原因是绘制时用的字体不支持中文或源码编码与编译编码不一致。解决编译加-encoding UTF-8绘制时显式指定支持中文的字体如new Font(Microsoft YaHei, Font.BOLD, 20)别依赖默认字体。6. 进阶把固定步长换成时间增量并做一次可验证的手感回归想让这份源码从「能玩」走到「手感稳」最值得动的一刀是把固定步长改成基于时间增量的更新。做法是在游戏循环里记录上一帧时间戳算出delta秒所有位移写成x speedPerSecond * delta。这样无论机器是 30 帧还是 120 帧鱼的实际移动速度一致卡顿也不会让游戏「变慢」。改完必须做回归验证否则很容易引入新的穿模问题。验证项操作方法通过标准速度一致性同一段路程分别在高/低负载下计时耗时差异不超过 10%碰撞不穿透让高速敌鱼正面撞玩家不出现「穿过去才判定」边界回收敌鱼移出屏幕后观察集合大小数量稳定不持续增长暂停恢复暂停 5 秒再继续鱼不瞬移、计时不乱时间增量还有个坑窗口最小化或系统休眠后恢复delta可能是一个巨大的值导致鱼瞬间飞出屏幕。稳妥做法是给delta设上限比如最大 0.05 秒超出就按上限算相当于主动丢帧而不是让物理崩掉。这个上限值我一般从 0.05 起调动作游戏可以更小休闲游戏可以放宽。改完这些再回头看最初那份「跑不起来」的源码问题往往就集中在资源路径和焦点两处跟玩法逻辑关系不大。从那以后我每次拆这类 Swing 小游戏都强制先做三件事确认入口类和资源加载方式、点一下窗口确认焦点、用命令行而不是 IDE 跑一遍。这三步走完后面改速度、改碰撞、加音效才有意义。希望帮到你。本文还有配套的精品资源点击获取