简介这是一份面向Java初学者与数据结构学习者的黄金矿工小游戏课程设计资源基于Java与GUI开发适合作为课程大作业、算法练手项目或自学研究素材。压缩包共28个文件约1.35MB包含5个java源码文件、7个class编译文件、10个png与5个jpg图片素材以及project、classpath、prefs等工程配置文件源码、资源文件与运行所需数据齐全导入后可直接运行测试。项目采用经典黄金矿工玩法涉及图形界面绘制、碰撞检测、定时器控制与抓钩角度计算等知识点能帮助读者理解面向对象设计、事件监听机制与基础算法在游戏中的落地方式。目前已有374人学习研究适合需要完成课程设计、巩固Java语法与数据结构应用的同学参考借鉴。1. 黄金矿工小游戏Java一个压缩包背后藏着多少可复用的工程套路很多人第一次看到「黄金矿工小游戏Java.zip」这个标题脑子里浮现的是童年 4399 那个甩钩子抓金块的 Flash 页面。但如果你是一名 Java 工程师或者正在准备 Java 面试题、想找一个能写进简历的练手项目这个压缩包的价值远不止「怀旧」两个字。它本质上是一个用 Java 图形界面技术实现的完整小游戏工程涵盖面向对象编程、定时器驱动、碰撞检测、状态机管理、资源加载这几个核心模块。你拿到它之后真正要问的不是「怎么运行」而是「这套代码能不能拆开、能不能改、能不能变成我自己的东西」。这篇文章就按这个思路走先讲清楚这个项目在技术栈上到底由什么构成再带你从零复现一个可运行的最小版本然后逐层加上钩子摆动、抓取判定、关卡计时这些真实游戏逻辑最后把踩过的坑和进阶改造方向一并交代。适合有 Java 基础、想通过一个完整小项目把面向对象和 GUI 编程串起来的人也适合想拿它当课程设计或面试项目底稿的开发者。2. 拆开这个压缩包Java 小游戏的技术选型与工程骨架2.1 为什么这类项目大多选 Swing 而不是 JavaFX拿到一个 Java 小游戏压缩包第一件事是看它用了哪套 GUI 库。黄金矿工这类项目绝大多数用的是 Swing AWT原因很实际Swing 是 JDK 自带的不需要额外配依赖javac编译完直接java就能跑对新手和环境配置不友好的人来说省掉了大量折腾。JavaFX 从 JDK 11 开始被移出标准库要单独引入模块虽然画面更现代但对于一个「打开就能玩」的小游戏来说Swing 的JPanelpaintComponent重绘机制已经够用。从工程结构上看一个典型的黄金矿工 Java 项目通常包含这几个包包名职责典型类core游戏主循环、窗口初始化GameFrame、GamePanelentity游戏对象建模Hook、Gold、Rock、Playerstate游戏状态管理GameState、LevelManagerutil资源加载、常量定义ImageLoader、GameConfig这个分层不是摆设。entity包里的每个类都对应屏幕上一种可交互对象Hook类负责钩子的摆动角度、伸长速度和抓取判定Gold类负责金块的位置、大小和分值。state包管的是「当前是第几关」「倒计时还剩多少」「游戏是否结束」。把状态和实体分开后面加新关卡、新道具的时候才不会牵一发动全身。2.2 用 Maven 还是裸 javac环境配置的取舍如果你只是想把压缩包跑起来裸javac就够了。但如果你打算改代码、加功能、甚至以后打包成可执行 jar我建议直接上 Maven。原因很简单资源文件的路径管理。Swing 项目里图片、音效通常放在src/main/resources下用getClass().getResource(/images/gold.png)加载。裸 javac 编译时资源不会自动复制到 classpath你得手动cp很容易出现「代码没错但图片加载不出来」的玄学问题。Maven 的pom.xml最小配置只需要指定编译版本和主类project modelVersion4.0.0/modelVersion groupIdcom.example/groupId artifactIdgold-miner/artifactId version1.0/version properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target /properties build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId configuration archive manifest mainClasscom.example.core.GameFrame/mainClass /manifest /archive /configuration /plugin /plugins /build /project这段配置做了两件事把编译级别锁在 Java 17你也可以改成 8 或 11看压缩包里的代码用了什么语法以及告诉 Maven 打包时把GameFrame设为主类。maven.compiler.source和target这两个参数必须一致否则会出现「class 文件版本不对」的启动失败。如果你机器上有多个 JDK记得用JAVA_HOME指向你要用的那个别让java -version和javac -version输出不一致——这是 Java 环境配置里最经典的翻车点。2.3 游戏主循环Timer 还是 Thread.sleepSwing 里做游戏循环常见做法有两种javax.swing.Timer和自定义ThreadThread.sleep。Timer的好处是它的回调在 EDT事件调度线程上执行你可以在回调里直接改组件状态、调repaint()不用担心线程安全问题。缺点是精度一般设 16ms 实际可能是 20ms 甚至更多画面会有轻微抖动。自定义线程的精度更高但你必须把所有 UI 更新操作通过SwingUtilities.invokeLater()丢回 EDT否则会出现「界面偶尔卡死」或者「组件状态不一致」的诡异现象。对于黄金矿工这种对帧率要求不极端的游戏我一般直接用Timer代码简单出问题也好排查。// GamePanel 构造函数里启动主循环 Timer timer new Timer(16, e - { updateGame(); // 更新钩子角度、金块状态、倒计时 repaint(); // 触发 paintComponent 重绘 }); timer.start();Timer的第一个参数是间隔毫秒数16ms 约等于 60FPS。updateGame()里做逻辑更新repaint()通知 Swing 重绘。注意不要在updateGame()里做耗时操作比如读文件、网络请求否则 EDT 被阻塞界面直接卡住。这是 Swing 游戏开发里最容易犯的错之一。3. 从零复现最小可玩版本钩子摆动与抓取判定3.1 钩子的旋转与伸长用三角函数算坐标黄金矿工的核心机制就一个钩子从顶部中心点出发按当前角度摆动按下空格后沿该角度伸长碰到金块或石头就抓回来。钩子的状态可以用三个变量描述角度angle、当前长度length、状态state摆动中 / 伸长中 / 收回中。摆动阶段角度在minAngle和maxAngle之间来回变化常见范围是 30° 到 150°以水平向右为 0°顺时针为正。每帧角度增量angleSpeed通常设 1° 到 2°太大钩子晃得太快太小又显得迟钝。// Hook.java 核心更新逻辑 public void update() { switch (state) { case SWINGING: angle angleSpeed * direction; if (angle maxAngle || angle minAngle) { direction * -1; // 到达边界反向 } break; case EXTENDING: length extendSpeed; if (length maxLength) { state State.RETRACTING; // 伸到最长自动收回 } break; case RETRACTING: length - retractSpeed; if (length minLength) { length minLength; state State.SWINGING; } break; } }钩子末端坐标用极坐标转直角坐标算int endX (int) (originX length * Math.cos(Math.toRadians(angle))); int endY (int) (originY length * Math.sin(Math.toRadians(angle)));originX、originY是钩子悬挂点通常在面板顶部中央。Math.toRadians把角度转弧度因为Math.cos接收的是弧度。这里有个容易忽略的点Swing 的 y 轴向下为正所以角度 90° 时sin为正钩子朝下符合直觉。如果你从数学坐标系直接搬公式画面会上下颠倒。3.2 抓取判定矩形碰撞还是圆形碰撞钩子末端和金块的碰撞检测最简单的是矩形相交把钩子末端当成一个小矩形金块也是矩形用Rectangle.intersects()判断。但黄金矿工里金块形状不规则用矩形会出现在「视觉上没碰到但判定抓到了」的情况玩家会觉得手感很怪。更稳的做法是用圆形碰撞钩子末端一个半径hookRadius金块一个半径goldRadius算两个圆心距离是否小于半径之和。public boolean checkCollision(Hook hook, Gold gold) { int hookEndX hook.getEndX(); int hookEndY hook.getEndY(); int goldCenterX gold.getX() gold.getWidth() / 2; int goldCenterY gold.getY() gold.getHeight() / 2; double distance Math.sqrt( Math.pow(hookEndX - goldCenterX, 2) Math.pow(hookEndY - goldCenterY, 2) ); return distance hook.getRadius() gold.getRadius(); }hookRadius一般设 8 到 12 像素goldRadius根据金块大小设 15 到 30 像素。这两个参数直接决定游戏手感半径设大了钩子离老远就能抓到玩家觉得太简单设小了明明碰到了却没反应玩家觉得「这游戏有 bug」。我一般会把hookRadius设得比钩子图片略小一点让判定稍微严格一些玩起来更有「精准抓取」的成就感。3.3 金块与石头的差异化处理抓到东西之后收回速度取决于抓的是什么。金块越小分值越高但收回越快大金块分值高但收回慢石头分值低甚至倒扣分收回速度也慢。这个设计是为了让玩家在「抓大还是抓小」「抓金还是抓石」之间做取舍。// 根据被抓对象类型决定收回速度 public void onGrab(GameObject obj) { if (obj instanceof Gold) { Gold gold (Gold) obj; this.retractSpeed gold.getWeight() 50 ? 2 : 5; this.currentScore gold.getScore(); } else if (obj instanceof Rock) { this.retractSpeed 1; // 石头收回极慢 this.currentScore -10; } this.state State.RETRACTING; }getWeight()返回金块重量重量越大收回越慢。这个参数不要设得太极端否则玩家等一个金块收回来要好几秒体验会很差。常见做法是最慢 2 像素/帧最快 6 像素/帧配合 60FPS 的主循环收回时间在 0.5 到 2 秒之间。4. 关卡、计时与状态机让游戏真正「能玩下去」4.1 关卡数据结构怎么设计一个关卡需要描述有哪些金块、每个金块的位置和大小、目标分数、限时。最直接的方式是用一个Level类里面放一个ListGold和一个ListRock再加targetScore和timeLimit。public class Level { private int levelNumber; private ListGold golds; private ListRock rocks; private int targetScore; private int timeLimit; // 秒 public static Level createLevel(int n) { Level level new Level(); level.levelNumber n; level.golds new ArrayList(); level.rocks new ArrayList(); // 根据关卡编号生成不同布局 Random rand new Random(n * 1000L); // 固定种子保证可复现 for (int i 0; i 5 n; i) { level.golds.add(new Gold( rand.nextInt(600) 100, rand.nextInt(300) 200, rand.nextInt(3) // 大小类型 )); } level.targetScore 200 n * 100; level.timeLimit 60; return level; } }用固定种子n * 1000L生成随机布局好处是同一关卡每次进入布局一致玩家可以记住金块位置也方便调试。如果你想让每局都不一样把种子改成System.currentTimeMillis()就行。targetScore和timeLimit随关卡递增和递减形成难度曲线。4.2 倒计时与游戏状态切换游戏状态至少要有PLAYING、PAUSED、LEVEL_COMPLETE、GAME_OVER。状态切换的触发条件分别是倒计时归零且未达标 →GAME_OVER达标 →LEVEL_COMPLETE玩家按 P →PAUSED。// GamePanel 里每帧检查状态 private void updateGame() { if (state ! GameState.PLAYING) return; timeLeft - 0.016; // 每帧减 16ms if (timeLeft 0) { if (score level.getTargetScore()) { state GameState.LEVEL_COMPLETE; } else { state GameState.GAME_OVER; } return; } hook.update(); checkGrab(); }timeLeft用double存秒数每帧减0.016而不是减 1这样倒计时才平滑。如果你用int存秒数然后每秒减 1倒计时显示会一跳一跳的。checkGrab()里遍历所有金块和石头调碰撞检测命中就触发hook.onGrab()。4.3 分数结算与关卡过渡抓到东西收回后要把分数加到总分里然后从场景中移除被抓对象。注意移除操作不能在遍历List的过程中直接remove否则会抛ConcurrentModificationException。常见做法是用Iterator或者先标记再统一移除。private void checkGrab() { if (hook.getState() ! Hook.State.RETRACTING) return; IteratorGold it level.getGolds().iterator(); while (it.hasNext()) { Gold gold it.next(); if (checkCollision(hook, gold)) { hook.onGrab(gold); score gold.getScore(); it.remove(); // 用 Iterator 安全移除 break; } } }break很重要钩子一次只能抓一个东西抓到就跳出循环。如果不加break钩子路径上多个金块会被同时抓走分数直接爆炸。这个 bug 我在早期版本里踩过测试时没发现因为金块摆得比较散后来把金块摆密了才暴露出来。5. 避坑与排查Java 小游戏开发中最容易翻车的 5 个点5.1 图片加载不出来控制台却没有任何报错现象代码里写了new ImageIcon(images/gold.png)运行时界面空白但控制台不报错。原因相对路径是相对于「工作目录」而不是「class 文件目录」。你在 IDE 里运行工作目录是项目根目录图片能找到打包成 jar 后工作目录变成 jar 所在目录相对路径就失效了。解决统一用 classpath 加载getClass().getResource(/images/gold.png)图片放在src/main/resources/images/下。这样无论怎么运行只要图片在 classpath 里就能找到。5.2 界面偶尔卡死鼠标点不动现象游戏运行一段时间后界面突然不响应过几秒又恢复。原因在 EDT 上做了耗时操作比如在paintComponent里读图片文件、在Timer回调里做大量计算。EDT 被阻塞期间所有事件点击、重绘都排队等待。解决图片在游戏初始化时一次性加载到内存paintComponent里只做绘制耗时逻辑放到独立线程通过SwingUtilities.invokeLater()更新 UI。5.3 钩子抓取判定「时灵时不灵」现象明明看到钩子碰到金块了但没抓起来有时候离得挺远却抓到了。原因碰撞检测用的坐标和绘制用的坐标不一致。比如绘制时用了gold.getX() offset但碰撞检测里只用了gold.getX()。解决把「逻辑坐标」和「绘制坐标」统一。所有实体类只维护一套坐标绘制时直接用碰撞检测也用同一套。如果确实需要偏移把偏移量写进实体类的getCenterX()方法里保证两边调的是同一个方法。5.4 打包成 jar 后启动失败提示「no main manifest attribute」现象java -jar gold-miner.jar报错说找不到主类。原因jar 的MANIFEST.MF里没有Main-Class字段或者字段值写错了比如带了.class后缀。解决用 Maven 的maven-jar-plugin配置mainClass值写全限定类名不带.class。如果手动打包用jar cfe gold-miner.jar com.example.core.GameFrame *.classcfe的e就是指定入口类。5.5 多 JDK 环境下编译通过但运行报「UnsupportedClassVersionError」现象javac编译没问题java运行时报类版本不支持。原因javac和java指向了不同版本的 JDK。比如javac是 17java是 817 编译出的 class 文件版本是 61Java 8 只认到 52。解决用javac -version和java -version确认版本一致。不一致就调整PATH或JAVA_HOME。在 Maven 项目里maven.compiler.source和target设成你运行环境支持的版本别设太高。6. 进阶改造把黄金矿工变成你自己的项目底稿6.1 加道具系统炸弹与强力钩基础版玩久了会腻加道具是最简单的扩展方向。炸弹道具可以让玩家炸掉一块石头强力钩可以让下一次抓取速度翻倍。实现上在Hook类里加一个powerMode布尔值在onGrab里判断public void onGrab(GameObject obj) { int baseSpeed obj instanceof Gold ? 5 : 1; this.retractSpeed powerMode ? baseSpeed * 2 : baseSpeed; this.powerMode false; // 用完即失效 }道具的获取方式可以是在场景里随机生成一个Item对象钩子抓到就触发效果。Item类继承GameObject和Gold、Rock平级这样碰撞检测逻辑不用改直接复用。6.2 用 JSON 配置关卡而不是硬编码硬编码关卡数据的问题是改一个数值就要重新编译。把关卡数据抽到 JSON 文件里用 Jackson 或 Gson 解析改关卡不用动代码。{ level: 1, targetScore: 300, timeLimit: 60, golds: [ {x: 200, y: 300, size: small, score: 50}, {x: 450, y: 400, size: large, score: 150} ], rocks: [ {x: 350, y: 350, size: medium} ] }解析代码用 Gson 三行搞定Gson gson new Gson(); LevelConfig config gson.fromJson( new InputStreamReader(getClass().getResourceAsStream(/levels/level1.json)), LevelConfig.class );LevelConfig是一个和 JSON 结构对应的 POJO字段名一致即可。这样你甚至可以让策划或者你自己用文本编辑器改关卡不用碰 Java 代码。6.3 验证改造是否成功的三个检查点改完代码怎么确认没改坏我一般跑这三个检查第一边界检查钩子摆到最大角度和最小角度时画面有没有超出面板边界。常见问题是角度范围设成 0° 到 180°钩子会水平打到左右边框视觉上很怪。改成 30° 到 150° 就正常了。第二抓取一致性连续抓 10 次看是否每次都能正确判定。如果出现「明明碰到却没抓到」检查碰撞半径是不是设太小如果出现「没碰到却抓到了」检查是不是用了矩形碰撞而金块图片有透明区域。第三状态切换倒计时归零时分数达标和不达标两种情况都要测。达标进下一关不达标进游戏结束画面不能出现「倒计时归零后游戏卡住不动」的情况。6.4 一个我踩过的坑别在 paintComponent 里 new 对象最后说一个血泪经验。早期版本里我在paintComponent里写了new Font(Arial, Font.BOLD, 20)来画分数文字结果游戏跑几分钟后明显变卡。原因是paintComponent每帧调用一次每次都创建新Font对象GC 压力巨大。后来把Font、Color这些不变对象提到类字段里初始化卡顿直接消失。Swing 游戏里paintComponent只做绘制不做对象创建这条规则能帮你避开很多性能问题。如果你打算把这个黄金矿工项目写进简历或者当课程设计我的建议是先跑通基础版然后至少加一个自己的改造点比如道具系统或者 JSON 关卡配置。面试官看这种项目不看你写了多少行代码看的是你有没有理解「为什么这么设计」以及「遇到问题怎么排查」。希望帮到你。本文还有配套的精品资源点击获取 Java黄金矿工小游戏实战：Swing游戏循环与碰撞检测
简介这是一份面向Java初学者与数据结构学习者的黄金矿工小游戏课程设计资源基于Java与GUI开发适合作为课程大作业、算法练手项目或自学研究素材。压缩包共28个文件约1.35MB包含5个java源码文件、7个class编译文件、10个png与5个jpg图片素材以及project、classpath、prefs等工程配置文件源码、资源文件与运行所需数据齐全导入后可直接运行测试。项目采用经典黄金矿工玩法涉及图形界面绘制、碰撞检测、定时器控制与抓钩角度计算等知识点能帮助读者理解面向对象设计、事件监听机制与基础算法在游戏中的落地方式。目前已有374人学习研究适合需要完成课程设计、巩固Java语法与数据结构应用的同学参考借鉴。1. 黄金矿工小游戏Java一个压缩包背后藏着多少可复用的工程套路很多人第一次看到「黄金矿工小游戏Java.zip」这个标题脑子里浮现的是童年 4399 那个甩钩子抓金块的 Flash 页面。但如果你是一名 Java 工程师或者正在准备 Java 面试题、想找一个能写进简历的练手项目这个压缩包的价值远不止「怀旧」两个字。它本质上是一个用 Java 图形界面技术实现的完整小游戏工程涵盖面向对象编程、定时器驱动、碰撞检测、状态机管理、资源加载这几个核心模块。你拿到它之后真正要问的不是「怎么运行」而是「这套代码能不能拆开、能不能改、能不能变成我自己的东西」。这篇文章就按这个思路走先讲清楚这个项目在技术栈上到底由什么构成再带你从零复现一个可运行的最小版本然后逐层加上钩子摆动、抓取判定、关卡计时这些真实游戏逻辑最后把踩过的坑和进阶改造方向一并交代。适合有 Java 基础、想通过一个完整小项目把面向对象和 GUI 编程串起来的人也适合想拿它当课程设计或面试项目底稿的开发者。2. 拆开这个压缩包Java 小游戏的技术选型与工程骨架2.1 为什么这类项目大多选 Swing 而不是 JavaFX拿到一个 Java 小游戏压缩包第一件事是看它用了哪套 GUI 库。黄金矿工这类项目绝大多数用的是 Swing AWT原因很实际Swing 是 JDK 自带的不需要额外配依赖javac编译完直接java就能跑对新手和环境配置不友好的人来说省掉了大量折腾。JavaFX 从 JDK 11 开始被移出标准库要单独引入模块虽然画面更现代但对于一个「打开就能玩」的小游戏来说Swing 的JPanelpaintComponent重绘机制已经够用。从工程结构上看一个典型的黄金矿工 Java 项目通常包含这几个包包名职责典型类core游戏主循环、窗口初始化GameFrame、GamePanelentity游戏对象建模Hook、Gold、Rock、Playerstate游戏状态管理GameState、LevelManagerutil资源加载、常量定义ImageLoader、GameConfig这个分层不是摆设。entity包里的每个类都对应屏幕上一种可交互对象Hook类负责钩子的摆动角度、伸长速度和抓取判定Gold类负责金块的位置、大小和分值。state包管的是「当前是第几关」「倒计时还剩多少」「游戏是否结束」。把状态和实体分开后面加新关卡、新道具的时候才不会牵一发动全身。2.2 用 Maven 还是裸 javac环境配置的取舍如果你只是想把压缩包跑起来裸javac就够了。但如果你打算改代码、加功能、甚至以后打包成可执行 jar我建议直接上 Maven。原因很简单资源文件的路径管理。Swing 项目里图片、音效通常放在src/main/resources下用getClass().getResource(/images/gold.png)加载。裸 javac 编译时资源不会自动复制到 classpath你得手动cp很容易出现「代码没错但图片加载不出来」的玄学问题。Maven 的pom.xml最小配置只需要指定编译版本和主类project modelVersion4.0.0/modelVersion groupIdcom.example/groupId artifactIdgold-miner/artifactId version1.0/version properties maven.compiler.source17/maven.compiler.source maven.compiler.target17/maven.compiler.target /properties build plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId configuration archive manifest mainClasscom.example.core.GameFrame/mainClass /manifest /archive /configuration /plugin /plugins /build /project这段配置做了两件事把编译级别锁在 Java 17你也可以改成 8 或 11看压缩包里的代码用了什么语法以及告诉 Maven 打包时把GameFrame设为主类。maven.compiler.source和target这两个参数必须一致否则会出现「class 文件版本不对」的启动失败。如果你机器上有多个 JDK记得用JAVA_HOME指向你要用的那个别让java -version和javac -version输出不一致——这是 Java 环境配置里最经典的翻车点。2.3 游戏主循环Timer 还是 Thread.sleepSwing 里做游戏循环常见做法有两种javax.swing.Timer和自定义ThreadThread.sleep。Timer的好处是它的回调在 EDT事件调度线程上执行你可以在回调里直接改组件状态、调repaint()不用担心线程安全问题。缺点是精度一般设 16ms 实际可能是 20ms 甚至更多画面会有轻微抖动。自定义线程的精度更高但你必须把所有 UI 更新操作通过SwingUtilities.invokeLater()丢回 EDT否则会出现「界面偶尔卡死」或者「组件状态不一致」的诡异现象。对于黄金矿工这种对帧率要求不极端的游戏我一般直接用Timer代码简单出问题也好排查。// GamePanel 构造函数里启动主循环 Timer timer new Timer(16, e - { updateGame(); // 更新钩子角度、金块状态、倒计时 repaint(); // 触发 paintComponent 重绘 }); timer.start();Timer的第一个参数是间隔毫秒数16ms 约等于 60FPS。updateGame()里做逻辑更新repaint()通知 Swing 重绘。注意不要在updateGame()里做耗时操作比如读文件、网络请求否则 EDT 被阻塞界面直接卡住。这是 Swing 游戏开发里最容易犯的错之一。3. 从零复现最小可玩版本钩子摆动与抓取判定3.1 钩子的旋转与伸长用三角函数算坐标黄金矿工的核心机制就一个钩子从顶部中心点出发按当前角度摆动按下空格后沿该角度伸长碰到金块或石头就抓回来。钩子的状态可以用三个变量描述角度angle、当前长度length、状态state摆动中 / 伸长中 / 收回中。摆动阶段角度在minAngle和maxAngle之间来回变化常见范围是 30° 到 150°以水平向右为 0°顺时针为正。每帧角度增量angleSpeed通常设 1° 到 2°太大钩子晃得太快太小又显得迟钝。// Hook.java 核心更新逻辑 public void update() { switch (state) { case SWINGING: angle angleSpeed * direction; if (angle maxAngle || angle minAngle) { direction * -1; // 到达边界反向 } break; case EXTENDING: length extendSpeed; if (length maxLength) { state State.RETRACTING; // 伸到最长自动收回 } break; case RETRACTING: length - retractSpeed; if (length minLength) { length minLength; state State.SWINGING; } break; } }钩子末端坐标用极坐标转直角坐标算int endX (int) (originX length * Math.cos(Math.toRadians(angle))); int endY (int) (originY length * Math.sin(Math.toRadians(angle)));originX、originY是钩子悬挂点通常在面板顶部中央。Math.toRadians把角度转弧度因为Math.cos接收的是弧度。这里有个容易忽略的点Swing 的 y 轴向下为正所以角度 90° 时sin为正钩子朝下符合直觉。如果你从数学坐标系直接搬公式画面会上下颠倒。3.2 抓取判定矩形碰撞还是圆形碰撞钩子末端和金块的碰撞检测最简单的是矩形相交把钩子末端当成一个小矩形金块也是矩形用Rectangle.intersects()判断。但黄金矿工里金块形状不规则用矩形会出现在「视觉上没碰到但判定抓到了」的情况玩家会觉得手感很怪。更稳的做法是用圆形碰撞钩子末端一个半径hookRadius金块一个半径goldRadius算两个圆心距离是否小于半径之和。public boolean checkCollision(Hook hook, Gold gold) { int hookEndX hook.getEndX(); int hookEndY hook.getEndY(); int goldCenterX gold.getX() gold.getWidth() / 2; int goldCenterY gold.getY() gold.getHeight() / 2; double distance Math.sqrt( Math.pow(hookEndX - goldCenterX, 2) Math.pow(hookEndY - goldCenterY, 2) ); return distance hook.getRadius() gold.getRadius(); }hookRadius一般设 8 到 12 像素goldRadius根据金块大小设 15 到 30 像素。这两个参数直接决定游戏手感半径设大了钩子离老远就能抓到玩家觉得太简单设小了明明碰到了却没反应玩家觉得「这游戏有 bug」。我一般会把hookRadius设得比钩子图片略小一点让判定稍微严格一些玩起来更有「精准抓取」的成就感。3.3 金块与石头的差异化处理抓到东西之后收回速度取决于抓的是什么。金块越小分值越高但收回越快大金块分值高但收回慢石头分值低甚至倒扣分收回速度也慢。这个设计是为了让玩家在「抓大还是抓小」「抓金还是抓石」之间做取舍。// 根据被抓对象类型决定收回速度 public void onGrab(GameObject obj) { if (obj instanceof Gold) { Gold gold (Gold) obj; this.retractSpeed gold.getWeight() 50 ? 2 : 5; this.currentScore gold.getScore(); } else if (obj instanceof Rock) { this.retractSpeed 1; // 石头收回极慢 this.currentScore -10; } this.state State.RETRACTING; }getWeight()返回金块重量重量越大收回越慢。这个参数不要设得太极端否则玩家等一个金块收回来要好几秒体验会很差。常见做法是最慢 2 像素/帧最快 6 像素/帧配合 60FPS 的主循环收回时间在 0.5 到 2 秒之间。4. 关卡、计时与状态机让游戏真正「能玩下去」4.1 关卡数据结构怎么设计一个关卡需要描述有哪些金块、每个金块的位置和大小、目标分数、限时。最直接的方式是用一个Level类里面放一个ListGold和一个ListRock再加targetScore和timeLimit。public class Level { private int levelNumber; private ListGold golds; private ListRock rocks; private int targetScore; private int timeLimit; // 秒 public static Level createLevel(int n) { Level level new Level(); level.levelNumber n; level.golds new ArrayList(); level.rocks new ArrayList(); // 根据关卡编号生成不同布局 Random rand new Random(n * 1000L); // 固定种子保证可复现 for (int i 0; i 5 n; i) { level.golds.add(new Gold( rand.nextInt(600) 100, rand.nextInt(300) 200, rand.nextInt(3) // 大小类型 )); } level.targetScore 200 n * 100; level.timeLimit 60; return level; } }用固定种子n * 1000L生成随机布局好处是同一关卡每次进入布局一致玩家可以记住金块位置也方便调试。如果你想让每局都不一样把种子改成System.currentTimeMillis()就行。targetScore和timeLimit随关卡递增和递减形成难度曲线。4.2 倒计时与游戏状态切换游戏状态至少要有PLAYING、PAUSED、LEVEL_COMPLETE、GAME_OVER。状态切换的触发条件分别是倒计时归零且未达标 →GAME_OVER达标 →LEVEL_COMPLETE玩家按 P →PAUSED。// GamePanel 里每帧检查状态 private void updateGame() { if (state ! GameState.PLAYING) return; timeLeft - 0.016; // 每帧减 16ms if (timeLeft 0) { if (score level.getTargetScore()) { state GameState.LEVEL_COMPLETE; } else { state GameState.GAME_OVER; } return; } hook.update(); checkGrab(); }timeLeft用double存秒数每帧减0.016而不是减 1这样倒计时才平滑。如果你用int存秒数然后每秒减 1倒计时显示会一跳一跳的。checkGrab()里遍历所有金块和石头调碰撞检测命中就触发hook.onGrab()。4.3 分数结算与关卡过渡抓到东西收回后要把分数加到总分里然后从场景中移除被抓对象。注意移除操作不能在遍历List的过程中直接remove否则会抛ConcurrentModificationException。常见做法是用Iterator或者先标记再统一移除。private void checkGrab() { if (hook.getState() ! Hook.State.RETRACTING) return; IteratorGold it level.getGolds().iterator(); while (it.hasNext()) { Gold gold it.next(); if (checkCollision(hook, gold)) { hook.onGrab(gold); score gold.getScore(); it.remove(); // 用 Iterator 安全移除 break; } } }break很重要钩子一次只能抓一个东西抓到就跳出循环。如果不加break钩子路径上多个金块会被同时抓走分数直接爆炸。这个 bug 我在早期版本里踩过测试时没发现因为金块摆得比较散后来把金块摆密了才暴露出来。5. 避坑与排查Java 小游戏开发中最容易翻车的 5 个点5.1 图片加载不出来控制台却没有任何报错现象代码里写了new ImageIcon(images/gold.png)运行时界面空白但控制台不报错。原因相对路径是相对于「工作目录」而不是「class 文件目录」。你在 IDE 里运行工作目录是项目根目录图片能找到打包成 jar 后工作目录变成 jar 所在目录相对路径就失效了。解决统一用 classpath 加载getClass().getResource(/images/gold.png)图片放在src/main/resources/images/下。这样无论怎么运行只要图片在 classpath 里就能找到。5.2 界面偶尔卡死鼠标点不动现象游戏运行一段时间后界面突然不响应过几秒又恢复。原因在 EDT 上做了耗时操作比如在paintComponent里读图片文件、在Timer回调里做大量计算。EDT 被阻塞期间所有事件点击、重绘都排队等待。解决图片在游戏初始化时一次性加载到内存paintComponent里只做绘制耗时逻辑放到独立线程通过SwingUtilities.invokeLater()更新 UI。5.3 钩子抓取判定「时灵时不灵」现象明明看到钩子碰到金块了但没抓起来有时候离得挺远却抓到了。原因碰撞检测用的坐标和绘制用的坐标不一致。比如绘制时用了gold.getX() offset但碰撞检测里只用了gold.getX()。解决把「逻辑坐标」和「绘制坐标」统一。所有实体类只维护一套坐标绘制时直接用碰撞检测也用同一套。如果确实需要偏移把偏移量写进实体类的getCenterX()方法里保证两边调的是同一个方法。5.4 打包成 jar 后启动失败提示「no main manifest attribute」现象java -jar gold-miner.jar报错说找不到主类。原因jar 的MANIFEST.MF里没有Main-Class字段或者字段值写错了比如带了.class后缀。解决用 Maven 的maven-jar-plugin配置mainClass值写全限定类名不带.class。如果手动打包用jar cfe gold-miner.jar com.example.core.GameFrame *.classcfe的e就是指定入口类。5.5 多 JDK 环境下编译通过但运行报「UnsupportedClassVersionError」现象javac编译没问题java运行时报类版本不支持。原因javac和java指向了不同版本的 JDK。比如javac是 17java是 817 编译出的 class 文件版本是 61Java 8 只认到 52。解决用javac -version和java -version确认版本一致。不一致就调整PATH或JAVA_HOME。在 Maven 项目里maven.compiler.source和target设成你运行环境支持的版本别设太高。6. 进阶改造把黄金矿工变成你自己的项目底稿6.1 加道具系统炸弹与强力钩基础版玩久了会腻加道具是最简单的扩展方向。炸弹道具可以让玩家炸掉一块石头强力钩可以让下一次抓取速度翻倍。实现上在Hook类里加一个powerMode布尔值在onGrab里判断public void onGrab(GameObject obj) { int baseSpeed obj instanceof Gold ? 5 : 1; this.retractSpeed powerMode ? baseSpeed * 2 : baseSpeed; this.powerMode false; // 用完即失效 }道具的获取方式可以是在场景里随机生成一个Item对象钩子抓到就触发效果。Item类继承GameObject和Gold、Rock平级这样碰撞检测逻辑不用改直接复用。6.2 用 JSON 配置关卡而不是硬编码硬编码关卡数据的问题是改一个数值就要重新编译。把关卡数据抽到 JSON 文件里用 Jackson 或 Gson 解析改关卡不用动代码。{ level: 1, targetScore: 300, timeLimit: 60, golds: [ {x: 200, y: 300, size: small, score: 50}, {x: 450, y: 400, size: large, score: 150} ], rocks: [ {x: 350, y: 350, size: medium} ] }解析代码用 Gson 三行搞定Gson gson new Gson(); LevelConfig config gson.fromJson( new InputStreamReader(getClass().getResourceAsStream(/levels/level1.json)), LevelConfig.class );LevelConfig是一个和 JSON 结构对应的 POJO字段名一致即可。这样你甚至可以让策划或者你自己用文本编辑器改关卡不用碰 Java 代码。6.3 验证改造是否成功的三个检查点改完代码怎么确认没改坏我一般跑这三个检查第一边界检查钩子摆到最大角度和最小角度时画面有没有超出面板边界。常见问题是角度范围设成 0° 到 180°钩子会水平打到左右边框视觉上很怪。改成 30° 到 150° 就正常了。第二抓取一致性连续抓 10 次看是否每次都能正确判定。如果出现「明明碰到却没抓到」检查碰撞半径是不是设太小如果出现「没碰到却抓到了」检查是不是用了矩形碰撞而金块图片有透明区域。第三状态切换倒计时归零时分数达标和不达标两种情况都要测。达标进下一关不达标进游戏结束画面不能出现「倒计时归零后游戏卡住不动」的情况。6.4 一个我踩过的坑别在 paintComponent 里 new 对象最后说一个血泪经验。早期版本里我在paintComponent里写了new Font(Arial, Font.BOLD, 20)来画分数文字结果游戏跑几分钟后明显变卡。原因是paintComponent每帧调用一次每次都创建新Font对象GC 压力巨大。后来把Font、Color这些不变对象提到类字段里初始化卡顿直接消失。Swing 游戏里paintComponent只做绘制不做对象创建这条规则能帮你避开很多性能问题。如果你打算把这个黄金矿工项目写进简历或者当课程设计我的建议是先跑通基础版然后至少加一个自己的改造点比如道具系统或者 JSON 关卡配置。面试官看这种项目不看你写了多少行代码看的是你有没有理解「为什么这么设计」以及「遇到问题怎么排查」。希望帮到你。本文还有配套的精品资源点击获取