用Java Swing从零撸一个贪吃蛇（附完整源码和BGM）-平芜编程栈

从零构建Java Swing贪吃蛇：完整开发指南与实战技巧

第一次接触Java图形界面开发时，我选择了贪吃蛇作为入门项目。这个经典游戏看似简单，却涵盖了Swing开发的多个核心概念。本文将带你从零开始，逐步构建一个功能完整的贪吃蛇游戏，并深入解析每个实现细节背后的设计思想。

1. 环境准备与项目结构

在开始编码前，我们需要搭建基本的开发环境。推荐使用IntelliJ IDEA社区版作为开发工具，它提供了完善的Java支持且完全免费。

项目目录结构建议如下：

snake-game/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/ │ │ │ └── yourname/ │ │ │ ├── Main.java │ │ │ └── GamePanel.java │ │ └── resources/ │ │ ├── images/ │ │ │ ├── snake_head.png │ │ │ ├── snake_body.png │ │ │ └── food.png │ │ └── sounds/ │ │ └── bgm.wav ├── lib/ └── out/

关键依赖：

Java SE 8或更高版本
无需额外库，仅使用标准Swing组件

提示：资源文件应放在resources目录下，这是Maven/Gradle项目的标准做法，即使你不使用这些构建工具，保持这种结构也有利于未来扩展。

2. 游戏窗口与基础框架

游戏的主窗口是开发起点，我们使用JFrame作为容器。不同于简单示例，我们将实现更专业的窗口设置：

public class Main { public static void main(String[] args) { JFrame frame = new JFrame("贪吃蛇游戏"); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); frame.setSize(900, 720); frame.setResizable(false); // 固定窗口大小 frame.setLocationRelativeTo(null); // 屏幕居中 GamePanel gamePanel = new GamePanel(); frame.add(gamePanel); frame.setVisible(true); } }

窗口设置要点解析：

setResizable(false)防止玩家意外改变窗口大小导致布局问题
setLocationRelativeTo(null)让窗口在屏幕中央显示
明确的窗口标题提升用户体验

3. 游戏面板与核心逻辑实现

GamePanel类继承JPanel并实现KeyListener和ActionListener接口，这是Swing游戏的标准模式。我们将分步骤实现游戏核心功能。

3.1 游戏状态管理

首先定义游戏的各种状态变量：

public class GamePanel extends JPanel implements KeyListener, ActionListener { // 游戏状态 private boolean isRunning = false; private boolean isGameOver = false; private int score = 0; // 蛇的属性 private static final int UNIT_SIZE = 25; private int[] snakeX = new int[750]; private int[] snakeY = new int[750]; private int bodyParts = 3; private String direction = "RIGHT"; // 食物位置 private int foodX; private int foodY; // 计时器控制游戏速度 private Timer timer; private final int DELAY = 150; // 毫秒 }

状态管理技巧：

使用明确的布尔值区分不同游戏状态
常量UNIT_SIZE统一管理游戏单位尺寸
DELAY值控制游戏难度，值越大速度越慢

3.2 渲染游戏元素

重写paintComponent方法实现游戏渲染：

@Override protected void paintComponent(Graphics g) { super.paintComponent(g); drawBackground(g); drawSnake(g); drawFood(g); drawScore(g); if (!isRunning) { drawStartMessage(g); } if (isGameOver) { drawGameOverMessage(g); } } private void drawBackground(Graphics g) { g.setColor(Color.BLACK); g.fillRect(0, 0, getWidth(), getHeight()); g.setColor(Color.DARK_GRAY); for (int i = 0; i < getWidth()/UNIT_SIZE; i++) { for (int j = 0; j < getHeight()/UNIT_SIZE; j++) { if ((i + j) % 2 == 0) { g.fillRect(i * UNIT_SIZE, j * UNIT_SIZE, UNIT_SIZE, UNIT_SIZE); } } } }

渲染优化技巧：

分方法处理不同元素的绘制，提高代码可读性
棋盘式背景增强游戏视觉层次感
使用常量UNIT_SIZE保持元素对齐

4. 游戏逻辑实现

4.1 蛇的移动控制

实现ActionListener的actionPerformed方法处理游戏逻辑：

@Override public void actionPerformed(ActionEvent e) { if (isRunning && !isGameOver) { move(); checkFood(); checkCollisions(); } repaint(); } private void move() { // 移动身体 for (int i = bodyParts; i > 0; i--) { snakeX[i] = snakeX[i-1]; snakeY[i] = snakeY[i-1]; } // 移动头部 switch (direction) { case "UP" -> snakeY[0] -= UNIT_SIZE; case "DOWN" -> snakeY[0] += UNIT_SIZE; case "LEFT" -> snakeX[0] -= UNIT_SIZE; case "RIGHT" -> snakeX[0] += UNIT_SIZE; } }

移动逻辑要点：

身体跟随头部移动的经典实现方式
使用switch语句处理不同方向
UNIT_SIZE确保移动步长与渲染尺寸一致

4.2 碰撞检测与食物生成

private void checkCollisions() { // 检查墙壁碰撞 if (snakeX[0] < 0 || snakeX[0] >= getWidth() || snakeY[0] < 0 || snakeY[0] >= getHeight()) { isGameOver = true; } // 检查自身碰撞 for (int i = bodyParts; i > 0; i--) { if (snakeX[0] == snakeX[i] && snakeY[0] == snakeY[i]) { isGameOver = true; } } if (isGameOver) { timer.stop(); } } private void checkFood() { if (snakeX[0] == foodX && snakeY[0] == foodY) { bodyParts++; score += 10; spawnFood(); } } private void spawnFood() { foodX = random.nextInt((int)(getWidth()/UNIT_SIZE)) * UNIT_SIZE; foodY = random.nextInt((int)(getHeight()/UNIT_SIZE)) * UNIT_SIZE; // 确保食物不会生成在蛇身上 for (int i = 0; i < bodyParts; i++) { if (foodX == snakeX[i] && foodY == snakeY[i]) { spawnFood(); return; } } }

碰撞检测技巧：

边界检查使用>=而非>，避免边缘情况
递归生成食物确保不会出现在蛇身上
游戏结束立即停止计时器

5. 音效与用户体验增强

5.1 背景音乐实现

private void playBackgroundMusic() { try { AudioInputStream audioInputStream = AudioSystem.getAudioInputStream( getClass().getResource("/sounds/bgm.wav")); Clip clip = AudioSystem.getClip(); clip.open(audioInputStream); clip.loop(Clip.LOOP_CONTINUOUSLY); clip.start(); } catch (Exception e) { System.out.println("无法加载背景音乐: " + e.getMessage()); } }

音频处理注意事项：

使用try-catch处理可能的加载异常
资源文件应放在resources目录
循环播放提供持续的游戏氛围

5.2 键盘控制优化

@Override public void keyPressed(KeyEvent e) { switch (e.getKeyCode()) { case KeyEvent.VK_SPACE: if (isGameOver) { resetGame(); } else { isRunning = !isRunning; } break; case KeyEvent.VK_UP: if (!direction.equals("DOWN")) direction = "UP"; break; case KeyEvent.VK_DOWN: if (!direction.equals("UP")) direction = "DOWN"; break; case KeyEvent.VK_LEFT: if (!direction.equals("RIGHT")) direction = "LEFT"; break; case KeyEvent.VK_RIGHT: if (!direction.equals("LEFT")) direction = "RIGHT"; break; } }

控制优化点：

空格键切换暂停/继续状态
防止180度急转弯导致自撞
明确的按键响应提升操作手感

6. 高级功能扩展

基础版本完成后，可以考虑添加以下增强功能：

6.1 游戏难度系统

// 在GamePanel中添加 private int difficulty = 1; // 1-3级难度 private void updateGameSpeed() { int newDelay = switch (difficulty) { case 1 -> 200; // 简单 case 2 -> 150; // 中等 case 3 -> 100; // 困难 default -> 150; }; timer.setDelay(newDelay); }

6.2 存档与最高分记录

private void saveHighScore() { try { Files.writeString(Path.of("highscore.txt"), String.valueOf(score)); } catch (IOException e) { System.out.println("无法保存最高分: " + e.getMessage()); } } private int loadHighScore() { try { return Integer.parseInt(Files.readString(Path.of("highscore.txt"))); } catch (Exception e) { return 0; } }

6.3 视觉效果增强

private void drawSnake(Graphics g) { // 绘制头部 g.setColor(new Color(45, 180, 0)); g.fillRect(snakeX[0], snakeY[0], UNIT_SIZE, UNIT_SIZE); // 绘制身体 for (int i = 1; i < bodyParts; i++) { // 颜色渐变效果 int greenValue = 130 + (i * 2); if (greenValue > 255) greenValue = 255; g.setColor(new Color(45, greenValue, 0)); g.fillRect(snakeX[i], snakeY[i], UNIT_SIZE, UNIT_SIZE); // 身体连接处的装饰效果 g.setColor(Color.BLACK); g.drawLine(snakeX[i], snakeY[i], snakeX[i], snakeY[i] + UNIT_SIZE); } }

在实际项目中，我发现合理的颜色渐变能显著提升游戏视觉效果，而不会增加太多性能开销。对于初学者来说，从基础版本开始，逐步添加这些增强功能是最好的学习路径。