坦克大战Java源码深度解析：从Maven构建到多线程与碰撞检测实战

简介这是一份基于Java实现的坦克大战小游戏完整源码专为Java期末作业、课程设计场景打造也适合初学Java者通过实战项目掌握图形界面游戏开发、多线程与碰撞检测等核心知识。压缩包共87个文件大小仅1.07MB其中包含39个Java源文件作为程序主体31张动图与7张静态图用于坦克、炮弹、地图等游戏素材2个音频文件提供音效另有配置文件和说明文档结构与资源划分清晰便于阅读和二次修改。已有1531人学习参考。通过这份资源读者可以获取从游戏窗口创建、键盘控制、坦克绘制到敌方坦克自动移动与子弹碰撞处理的完整实现思路既能支撑课程设计答辩演示也能在此基础上扩展功能、加深对Java面向对象设计的理解以及事件监听、游戏循环、地图碰撞等机制的运用。1. 一门课设就把 Java 基础串成链这份坦克大战源码可以怎么用大多数期末作品死在两类问题上要么代码是控制台复读机写五百行 C 语言风格的 Java要么上来就做分布式游戏服务器三个月连登录都没调通。坦克大战刚刚好卡在及格线之上它要有状态、有并发、有碰撞还能让老师一眼看出工作量。这个 zip 解压之后是一个完整 Maven 工程tankBattle-master 目录里同时存在 src/main 和 src/test说明答案是奔着“能编译、能测试、能讲清楚”去的。对正在刷 Java 面试题的人这份源码的价值不只是用它写游戏而是把多线程、集合遍历、事件监听这些面试常客放进一个看得见摸得着的场景里。建议的学习路线是先跑起来再按自己的口味改造一个功能最后带着改动进答辩现场。2. 拆包与构建从 pom.xml 到游戏窗口2.1 先读目录再读代码拿到 zip 第一步不是双击 jar而是右键解压后直接看目录。tankBattle-master是典型的 GitHub 工程名Maven 标准结构都在。先看有没有src/test这比看 README 更能说明代码质量。很多课设代码只有 main老师问“你测试过吗”只能答“跑起来就是测过了”这份工程里有 test 目录你至少可以先跑一次mvn test看看原作者的断言覆盖了哪个模块。常见情况是测了坦克和子弹的矩形碰撞没测 UI这个能讲成“我没有被 Swing 的复杂状态干扰把核心逻辑拆成了可单元测试的类”。路径/文件内容答辩时对应的话术src/main/java主类、坦克类、子弹类、地图、碰撞处理面向对象与职责划分src/test/java单元测试基础测试意识pom.xml依赖和打包配置熟练使用 Maven 构建README.md运行与操作说明文档与交付意识.gitignore也存在说明这是从 git 仓库拉下来的不是生成了压缩包再改名。LICENSE 一般放着不动不用在答辩里专门提。2.2 pom.xml 里删不掉的三个配置打开 pom.xml 后第一眼要看的不是 dependency而是groupId、artifactId、version这三个坐标。坦克大战这种小游戏依赖不超过两个通常是 JUnit 控制测试阶段真正决定打包结果的是 build 节点。用 Maven 做期末项目的同学能准确说出这段配置的含义常常比多写一个类更让老师信服。build !-- 最终 jar 包名不写会变成 artifactId-version.jar -- finalNametankBattle/finalName plugins plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-compiler-plugin/artifactId /plugin plugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-jar-plugin/artifactId configuration archive manifest !-- 可执行 jar 的入口必须和实际主类全限定名一致 -- mainClass你的主类完整包名.类名/mainClass /manifest /archive /configuration /plugin /plugins /build properties !-- 阿里云镜像源上很多老工程不写这两行JDK17 以上会编译报错 -- maven.compiler.source8/maven.compiler.source maven.compiler.target8/maven.compiler.target /properties这里不把某个具体类名写死是因为不同仓库的主类位置不一样你解压后搜public static void main(String[] args)就能找到。maven-compiler-plugin 没写 version 的时候Maven 会按默认值走如果你本机的 JDK 是 17 或更高source和target默认值通常是 1.5 或 1.8控制台会报Source option 5 is no longer supported。出现这个报错回到 properties 补上上面两行即可。注意mainClass里的包名大小写也必须和 Java 文件里的package声明完全一致少写一个字母会在运行时提示Could not find or load main class。2.3 Maven 构建与验证命令在项目根目录打开命令行先执行编译再执行打包不要跳步。-DskipTests只是跳过 test 运行不会跳过test-compile这样既能验证 main 代码也不会因为原作者的测试依赖某个本机不存在的外部资源而失败。mvn clean package -DskipTests java -jar target/tankBattle.jar如果 target 下生成的 jar 名和 pom 里finalName不一致检查是不是父模块的finalName配置覆盖了当前模块。如果报主类找不到先在 IDEA 里定位main方法所在类再去 pom.xml 对比mainClass。类名不一致是课设项目重命名之后最常见的错误。跑通后建议再执行一次mvn test看原作者的测试用例是否全绿。这一步不会浪费多少时间但在答辩时能说“我跑过全部单元测试”效果和“我点了一下 run”完全不同。3. 帧循环、线程与集合遍历坦克大战源码里最容易翻车的三个点3.1 为什么不能让子弹自己动先分清 update 和 repaint游戏窗口里所有物体移动都是假象。你看到的坦克位移本质是每隔几十毫秒把坦克坐标改一次再把整个面板重绘一次。新手容易把子弹设计成每条线程循环改坐标子弹一多线程数爆炸而且多个线程同时调用 Swing 的repaint()会造成界面闪烁。常见做法是一个游戏线程统一推进所有对象状态主线程只负责接收键盘事件。private volatile boolean running true; public void gameLoop() { long lastTime System.nanoTime(); while (running) { long now System.nanoTime(); // 上一帧到这一帧的真实时间单位是秒 double delta (now - lastTime) / 1_000_000_000.0; lastTime now; updateGame(delta); gamePanel.repaint(); // 控制帧率上限并给事件线程喘息时间 long frameTime System.nanoTime() - now; long sleepMillis Math.max(0, (long) (1000 / TARGET_FPS) - frameTime / 1_000_000); try { Thread.sleep(sleepMillis); } catch (InterruptedException e) { Thread.currentThread().interrupt(); } } }这段循环里delta是上一帧消耗的真实秒数。坦克移动不用固定的x 5而是x speed * delta这样在 60Hz 和 144Hz 显示器上坦克既不会一会儿快一会儿慢也不会在不同机器上走出两套速度。TARGET_FPS建议取 60sleep 后的误差有 1 到 2 毫秒这个量级对坦克大战没有问题。running用 volatile 修饰是为了保证关闭窗口时另一个线程修改它后循环线程能立刻看到最新的值否则可能出现窗口已关闭但线程还在跑的情况。3.2 用固定时间步长还是可变态长方案优点缺点可变 delta代码简单渲染间隔不均匀碰撞检测可能跨过薄墙固定时间步长游戏逻辑稳定更新次数可能积压半固定步长控制最大帧时间逻辑略复杂需要 accumulator很多源码写的是可变 delta因为它的实现最短。我一般会把循环改成“固定逻辑步长 可变渲染”也就是在 while 里用累加器把1/60拆成若干次调用而不是直接把 delta 传入updateGame。这样做的好处是无论当前屏幕刷新率是多少坦克和子弹每次逻辑更新都走同样的步进测试用例也好写传入一个固定步长就能断言坐标结果。对课程设计而言可变 delta 也能过关但你得在答辩时解释清楚“为什么键盘按下后坦克移动的像素数会受休息时间影响”。3.3 遍历子弹列表删除时ConcurrentModificationException 是预习课子弹出界或者命中坦克后要从ListBullet里移除。最直觉的写法是增强 for 里调用bullets.remove(b)运行一会儿就会抛异常。原因是 ArrayList 的迭代器在创建时记录了expectedModCount而remove方法修改了modCount两者不一致就触发快速失败。这不是玄学是可以当场手写出来的知识点。ListBullet bullets new ArrayList(); public void updateBullets() { IteratorBullet iterator bullets.iterator(); while (iterator.hasNext()) { Bullet b iterator.next(); if (b.getY() 0 || hitWall(b)) { // 必须使用迭代器的 remove而不是 list.remove(b) iterator.remove(); } else { b.move(); } } }关键点是iterator.remove()会同步修改迭代器内部的 expectedModCount因此遍历期间只有一个安全删除入口。换成CopyOnWriteArrayList虽然能在遍历时直接 remove但每写一次都复制整个数组子弹数量几十枚的情况下性能问题不算致命但答辩时若被问“为什么不用 CopyOnWrite”你得说清楚写复制代价。建议优先用 Iterator 写法代码最少也最不容易错。4. 游戏对象设计、键盘监听与 AABB 矩形碰撞4.1 用枚举替代魔法数字方向参数化坦克至少四个方向如果每个方向维护一个布尔值代码里到处是if (up) { y - speed; }。枚举的写法让移动、转向、图像渲染共用同一套定义这也是 Java 基础里面向对象设计的典型考点。public enum Direction { UP, DOWN, LEFT, RIGHT; // 返回方向向量而不是直接去改坐标 public int xOffset() { if (this LEFT) return -1; if (this RIGHT) return 1; return 0; } public int yOffset() { if (this UP) return -1; if (this DOWN) return 1; return 0; } }坦克类里的移动变成public void move(Direction dir, double distance) { x dir.xOffset() * distance; y dir.yOffset() * distance; }xOffset()和yOffset()返回的是方向向量实际移动距离由外部传入这样速度控制和方向控制解耦。如果后面想给坦克加高速道具不需要改 Direction 类只需要把传入的 distance 放大。源代码里如果用的是 switch 直接在 move 里判断也请保留自己的实现但答辩时提一句“我知道有这种设计但当前写法更直观”比被问住强。4.2 键盘监听处理方向键粘连用 KeyListener 时一个经典 bug 是只记录最后一次按下的键。按住上不放再点一下右坦克就只往右走因为 keyPressed 覆盖了 keyCode。另一个问题是操作系统键盘重复事件会让状态被反复触发。合理做法是把按键状态放到 Set 里private final SetInteger pressedKeys new HashSet(); public void keyPressed(KeyEvent e) { // 只记录按键码不做实际移动保证输入和逻辑分离 pressedKeys.add(e.getKeyCode()); } public void keyReleased(KeyEvent e) { pressedKeys.remove(e.getKeyCode()); } public void update(double delta) { if (pressedKeys.contains(KeyEvent.VK_UP)) { tank.move(Direction.UP, TANK_SPEED * delta); } if (pressedKeys.contains(KeyEvent.VK_RIGHT)) { tank.move(Direction.RIGHT, TANK_SPEED * delta); } }Set 中每个键只保留一个状态按住上再按右时两个键都在集合里不会丢失方向。你还可以用pressedKeys.size()决定是否播放履带动画。Swing 的按键事件分发在 EDT 线程不能在 keyPressed 里做复杂计算把按键码写进集合后让 gameLoop 线程在下一帧读取是分割输入与逻辑的标准做法。另外注意不同操作系统上方向键的 keyCode 可能表示同一数字但不要依赖具体数字直接用KeyEvent.VK_UP常量更安全。4.3 AABB 碰撞检测为什么矩形就够用坦克大战的地图块、坦克身体、子弹几乎全是矩形。矩形碰撞检测用 AABB轴对齐包围盒比像素完美碰撞更快也更适合课程设计讲解。public static boolean intersects(Rectangle a, Rectangle b) { // AABB 检测四个不等式同时成立说明有重叠 return a.x b.x b.width a.x a.width b.x a.y b.y b.height a.y a.height b.y; }坐标原点在左上角所以“a 的左边小于 b 的右边a 的右边大于 b 的左边”就能确定横向重叠纵向同理。调用前先判断类型坦克和墙体做检测子弹和坦克做检测子弹和墙体做检测每种检测对象不同但函数同一个。调整参数时注意速度与尺寸比例对象常用初始值说明坦克速度120 像素/秒相当于每 16ms 移动 1.9 像素子弹速度300 像素/秒比坦克高但低于画面高度一半子弹尺寸8x8 左右比墙体小碰撞边界要用自己的宽高墙体格子30x30检查重叠时留 1 像素余量这里的数值是常见经验值源码中可能是别的常量你只要把speed * delta控制在单帧不超过目标物宽度的一半子弹就不会在视觉上“穿墙”。例如子弹 8px 宽300 px/s 在 60FPS 下单帧移动 5px是安全范围。5. 从“能玩”到“能答辩”存档、难度参数与三个必查坑5.1 用 Properties 写本地分数存档为了答辩演示很多同学会把最高分写在内存里关掉窗口就没了。直接在代码里写文件最方便的是Properties它天然支持中文虽然推荐用 ISO-8859-1但分数这种纯数字内容完全够用。private void saveScore(int score) { Properties props new Properties(); // 存高分时不直接拼字符串而是用 setProperty 统一编码 props.setProperty(highScore, Integer.toString(score)); Path path Paths.get(System.getProperty(user.home), .tankbattle); try (OutputStream out new FileOutputStream(path.resolve(save.properties).toFile())) { props.store(out, tank battle high score); } catch (IOException e) { e.printStackTrace(); } }路径放在user.home而不是项目目录是为了避免 target 目录被mvn clean清掉后存档跟着消失。加载侧用load(InputStream)读进来再Integer.parseInt(props.getProperty(highScore, 0))拿值第二个参数是默认值文件不存在也不会抛异常。5.2 把难度改成配置而不是改 if敌人数量、生成间隔、子弹速度是三个最容易让老师手动体验差异的旋钮。常见做法是建一个 GameConfig 类从 properties 读参数避免常量散落各文件。参数名可以写成enemy.count、enemy.spawnIntervalMs读取的代码和 5.1 完全一样只是load一次后所有类共享。5.3 答辩前按这个顺序检查跑一遍mvn clean package -DskipTests确认老师在你机器上也能一键启动把src/test下的测试用例至少看一遍能说出每个方法在验证哪条规则在keyPressed里打断点确认按键通道正常如果发现方向键卡死先检查pressedKeys是不是被写成了局部变量。如果源码里没有存档功能把上面的saveScore粘进去再把highScore打印到窗口标题栏这已经算一个完整功能扩展了。我通常会在intersects方法入口加一行System.out.println把两个矩形的坐标打出来跑几局后你就能从输出里直接看出是 x 边界写反还是 y 方向多减了墙体高度。本文还有配套的精品资源点击获取