Java课设贪吃蛇小游戏：Swing实现与答辩避坑指南

简介：这份资源是面向高校学生与Java初学者的贪吃蛇小游戏课程设计完整方案，包含可直接运行的源代码与配套课设报告，适合需要完成Java课设、课程作业或入门练手的人群。压缩包共38个文件，约25.66MB，涵盖java源码、class编译文件、xml配置、png图片素材、mp4运行录屏以及docx课设报告等，源码、素材与文档一应俱全，便于对照理解游戏逻辑与界面实现。目前已有119人学习下载，可作为课设参考与排错借鉴。资源采用最原始的界面风格，未做过度美化，更贴近学生实际水平，能有效避免因界面过于精致而引发质疑。读者可从中获取完整的贪吃蛇实现思路、可运行工程结构、操作演示录屏与报告撰写参考，快速搭建并跑通自己的课设项目。

1. 贪吃蛇小游戏（Java课设）：为什么它是最值得动手的 Java 入门项目

很多同学拿到「贪吃蛇小游戏（Java课设）」这个题目时，第一反应是去网上找一份源码改改交差。我带过几届课设答辩，见过太多雷同的 Swing 版本，也见过答辩时被问「蛇身怎么存储的」直接卡壳的。其实这个题目真正的价值不在游戏本身，而在于它逼你把 Java 基础里最核心的几块——面向对象、集合、事件驱动、线程与定时器——串成一个能跑起来、能看见结果的完整程序。它不像图书管理系统那样全是增删改查的模板代码，也不像算法题那样脱离工程。你写完之后，对「类怎么设计、状态怎么维护、界面怎么刷新」会有一套自己的手感。这篇笔记面向的是要交 Java 课设、或者想用一个小项目把 Java 基础打扎实的人，我会从选型讲到能跑通的最小实现，再讲清楚那些答辩时容易被追问、自己写时容易翻车的细节。

2. 技术选型与整体设计：Swing、JavaFX 还是控制台

2.1 三种实现路线的取舍

贪吃蛇在 Java 里至少有三种落地方式，选错了后面全是返工。第一种是纯控制台字符版，用二维数组打印，靠 Scanner 读方向。优点是零依赖、逻辑清晰，缺点是没法做课设答辩的演示效果，老师一看就觉得敷衍。第二种是 Swing，JDK 自带，JFrame+JPanel+Timer就能跑，网上资料最多，缺点是界面丑、要自己处理重绘。第三种是 JavaFX，界面现代、有AnimationTimer和场景图，但 JDK 11 之后 JavaFX 被移出标准库，要单独引依赖，课设环境里配置容易出问题。

我的建议很直接：课设就选 Swing。原因不是它好，而是它「够用且不折腾」。答辩机器上大概率是 JDK 8 或者装了 IDEA 的 JDK 17，Swing 两边都在标准库里，javax.swing.*直接 import 就能用，不会出现「在我电脑上能跑，在老师电脑上找不到模块」这种血泪场面。JavaFX 的模块化配置对新手就是个黑匣子，课设时间有限，不值得在这上面耗。

2.2 核心类的划分

不管哪种路线，贪吃蛇的领域模型是固定的，先把类分清楚，代码才不会写成一坨。我一般会拆成四个类：

这里最关键的一个决策是蛇身用什么存。很多人第一反应是ArrayList<Point>，能用，但每次移动都要add(0, newHead)再remove(size-1)，头部插入是 O(n)。用LinkedList的addFirst和removeLast都是 O(1)，语义也更贴合「蛇头进、蛇尾出」。这个点在答辩时经常被问，答得出来就是加分项。

2.3 游戏循环怎么驱动

Swing 里做动画有两种常见写法。一种是自己开一个Thread，里面while(true)加Thread.sleep，然后repaint()。另一种是用javax.swing.Timer，它会在事件分发线程（EDT）里按固定间隔触发ActionListener。新手容易踩的坑是：在自建线程里直接调repaint()或者改组件状态，会跟 EDT 抢资源，偶尔出现画面撕裂或者卡死，而且这种 bug 极难复现。

正确做法是用Timer。它把「定时」和「在 EDT 里更新 UI」两件事绑在一起，天然线程安全。间隔设多少？蛇的移动速度一般 100 到 200 毫秒一格。设 150ms 是比较舒服的手感，太快反应不过来，太慢显得卡。这个值后面可以做成难度参数。

// GamePanel 构造里初始化定时器 Timer timer = new Timer(150, new ActionListener() { @Override public void actionPerformed(ActionEvent e) { // 每次触发：蛇移动一格，然后重绘 snake.move(); checkCollision(); // 判断撞墙、撞自己、吃食物 repaint(); // 请求重绘，Swing 会回调 paintComponent } }); timer.start();

这段代码的逻辑是：Timer每 150ms 触发一次actionPerformed，在里面推进游戏状态再请求重绘。参数150就是移动间隔，改小变快、改大变慢。注意repaint()只是「请求」，真正的绘制发生在paintComponent(Graphics g)里，所有画蛇、画食物的代码都要写在那个方法里，不要在actionPerformed里直接画。

3. 从零跑通最小可玩版本：代码与参数

3.1 蛇的移动与方向控制

蛇的移动本质是「在头部加一个新格子，把尾部删掉」，如果这一步吃到了食物，就不删尾部，蛇自然变长。方向控制要防一个经典 bug：蛇正在向右走，你按左键，如果直接改方向，蛇会瞬间掉头撞到自己。解决办法是记录「当前方向」和「待生效方向」两个变量，或者简单点，在按键时判断新方向不能和当前方向相反。

public class Snake { private LinkedList<Point> body = new LinkedList<>(); private Direction dir = Direction.RIGHT; public Snake(int startX, int startY) { // 初始三节，水平排列 body.add(new Point(startX, startY)); body.add(new Point(startX - 1, startY)); body.add(new Point(startX - 2, startY)); } public void move() { Point head = body.getFirst(); Point newHead = new Point(head.x + dir.dx, head.y + dir.dy); body.addFirst(newHead); // 新头入队 body.removeLast(); // 去尾，吃到食物时这行不执行 } public void setDirection(Direction newDir) { // 禁止 180 度掉头 if (this.dir.dx + newDir.dx == 0 && this.dir.dy + newDir.dy == 0) { return; } this.dir = newDir; } }

Direction是个枚举，每个方向带dx、dy偏移量，比如RIGHT(1,0)、UP(0,-1)。注意屏幕坐标系 y 轴向下，所以向上是-1。setDirection里那句判断是防掉头的核心：如果新旧方向的偏移量互为相反数，就忽略这次输入。参数上，初始蛇长设 3 节比较合适，太短看不出蛇形，太长开局就快撞墙。

3.2 食物生成与碰撞判定

食物不能生成在蛇身上，否则一出生就「吃」到，逻辑会乱。生成时用一个循环，随机出坐标后检查是否和蛇身重合，重合就重摇。

public void spawnFood() { Random random = new Random(); while (true) { int x = random.nextInt(COLS); // COLS 是横向格子数 int y = random.nextInt(ROWS); Point p = new Point(x, y); if (!snake.getBody().contains(p)) { food = new Food(p); return; } } }

COLS和ROWS是网格的列数和行数，比如 30×20，格子大小 20 像素，那面板就是 600×400。碰撞判定分三种：撞墙（头坐标超出 0 到 COLS-1 或 0 到 ROWS-1）、撞自己（头坐标和身体其他节重合）、吃到食物（头坐标等于食物坐标）。吃到食物时不要删尾，并重新生成食物。

private void checkCollision() { Point head = snake.getBody().getFirst(); // 撞墙 if (head.x < 0 || head.x >= COLS || head.y < 0 || head.y >= ROWS) { gameOver(); return; } // 撞自己：从第 1 节开始比，跳过头部 for (int i = 1; i < snake.getBody().size(); i++) { if (head.equals(snake.getBody().get(i))) { gameOver(); return; } } // 吃食物 if (head.equals(food.getPos())) { snake.grow(); // 补回一节，抵消 move 里的 removeLast spawnFood(); score += 10; } }

这里有个容易忽略的点：grow()的实现。因为move()里已经removeLast了，吃到食物时要在尾部再补一节，位置取原来尾节点的坐标即可。分数每次加 10 是习惯，也可以按难度递增。

3.3 绘制与键盘监听

绘制全部在paintComponent里做，先画背景网格，再画食物，最后画蛇。蛇头可以用不同颜色区分，方便看方向。

@Override protected void paintComponent(Graphics g) { super.paintComponent(g); // 画食物 g.setColor(Color.RED); g.fillOval(food.getPos().x * CELL, food.getPos().y * CELL, CELL, CELL); // 画蛇 for (int i = 0; i < snake.getBody().size(); i++) { Point p = snake.getBody().get(i); g.setColor(i == 0 ? Color.ORANGE : Color.GREEN); // 蛇头橙色 g.fillRect(p.x * CELL, p.y * CELL, CELL, CELL); } }

CELL是单格像素，比如 20。键盘监听推荐用KeyAdapter重写keyPressed，或者用 Swing 的InputMap/ActionMap绑定方向键。前者简单，后者更规范但代码多。课设用KeyAdapter足够。

this.addKeyListener(new KeyAdapter() { @Override public void keyPressed(KeyEvent e) { switch (e.getKeyCode()) { case KeyEvent.VK_UP: snake.setDirection(Direction.UP); break; case KeyEvent.VK_DOWN: snake.setDirection(Direction.DOWN); break; case KeyEvent.VK_LEFT: snake.setDirection(Direction.LEFT); break; case KeyEvent.VK_RIGHT: snake.setDirection(Direction.RIGHT); break; } } }); this.setFocusable(true); // 关键：不设这个收不到键盘事件

setFocusable(true)是新手最常漏的一行，漏了之后按方向键毫无反应，查半天查不出来。另外GamePanel要requestFocusInWindow()，确保窗口一打开焦点就在面板上。

4. 避坑与排查：答辩前一定要过的 5 个坎

4.1 按方向键没反应

现象：程序能跑，蛇也在动，但键盘怎么按都不转向。原因：面板没有获得焦点，或者忘了setFocusable(true)。解决：在GamePanel构造里调用setFocusable(true)，并在GameFrame显示窗口后调一次panel.requestFocusInWindow()。如果还不行，检查是不是把KeyListener加到了JFrame而不是JPanel上。

4.2 蛇移动时画面闪烁

现象：蛇每走一步整个画面闪一下，看着很难受。原因：直接在paintComponent里画，Swing 默认会先用背景色清屏再画，两步之间就是闪烁。解决：开启双缓冲，JPanel默认已经开了，但如果你重写了paint而不是paintComponent，双缓冲会失效。确保重写的是paintComponent并调用super.paintComponent(g)。另外不要在actionPerformed里手动clearRect。

4.3 吃到食物后蛇没变长

现象：分数加了，食物也刷新了，但蛇长度不变。原因：move()里无条件removeLast，而grow()没有真正补回节点，或者补的位置不对。解决：grow()应该在尾部复制一份尾节点坐标再addLast，这样长度净增 1。检查checkCollision里调用grow()的时机，必须在move()之后。

4.4 蛇撞到自己却判成没撞

现象：蛇头明明压到身体，游戏却没结束。原因：碰撞循环从i = 0开始，把头和自己比了，或者用了==比较Point对象。Point的equals比较的是坐标值，==比较的是引用，必须用equals。解决：循环从i = 1开始，用head.equals(body.get(i))。

4.5 游戏结束后无法重开

现象：撞墙后弹出提示，关掉提示整个窗口卡死或者蛇还在动。原因：gameOver()里只弹了JOptionPane，没有timer.stop()，定时器还在触发。解决：gameOver()第一件事就是timer.stop()，然后再弹提示、记录最高分。想支持重开就重置Snake、Food、score，再timer.start()。

5. 进阶技巧：让课设从「能跑」变成「能拿高分」

把最小版本跑通只是及格线。答辩想拿高分，得在「可玩性」和「代码质量」上做文章。我一般会加三个东西，成本不高但效果明显。

第一个是难度递增。用一个level变量，每吃 5 个食物level++，同时把timer.setDelay()调小，比如从 150ms 降到 120ms、100ms。Timer的setDelay可以运行时改，改完立即生效。这样游戏越玩越快，演示时老师能直观看到「有难度设计」。

第二个是最高分持久化。用java.util.Properties或者简单的文件读写，把最高分存到本地文件，下次启动读出来。代码量不到 20 行，但答辩时能讲「数据持久化」，比纯内存版本高一个层次。

// 保存最高分 Properties props = new Properties(); props.setProperty("highScore", String.valueOf(highScore)); try (FileOutputStream out = new FileOutputStream("score.properties")) { props.store(out, "snake high score"); } catch (IOException e) { e.printStackTrace(); }

第三个是暂停/继续。空格键切换timer.stop()和timer.start()，加一个paused布尔量控制。这个功能演示时特别实用，老师问细节时可以暂停下来慢慢讲。

还有一个容易被忽视的点：代码结构。答辩老师翻代码时，最反感的是一个GamePanel里塞了 500 行，什么都往里写。把Snake、Food的职责分出去，GamePanel只负责绘制和调度，GameFrame只负责窗口。这样即使功能不多，代码看起来也专业。我自己的习惯是每个类顶部写一行注释说明职责，方法名用动词开头，move、spawnFood、checkCollision这种，别用doSomething。

最后说个验证方法：写完别急着交，自己完整玩三局，一局正常吃、一局故意撞墙、一局故意撞自己，看三种结束路径是否都正常。再让同学在另一台机器上跑一遍，确认没有环境依赖问题。课设翻车往往不是逻辑难，而是这些边角没测到。希望帮到你。

本文还有配套的精品资源，点击获取