Java俄罗斯方块源码解析：游戏主循环、碰撞检测与消行实现-北京尧图网络

简介这是一份面向Java初学者与游戏编程爱好者的俄罗斯方块完整源码以Java语言实现适合用来理解经典游戏的核心逻辑与面向对象设计。源码围绕游戏主面板、方块形状、流程控制器与程序入口等关键类展开涵盖游戏循环、方块生成与移动、碰撞检测、得分计算、结束判定及键盘交互等要点可帮助读者掌握一个简单游戏如何用代码落地。压缩包共38个文件约170KB包含18个png图片资源、14个class字节码、3个java源文件以及prefs、project、classpath等IDE配置便于在Eclipse等环境中直接导入与复用。目前已有2785人学习下载读者可对照源码梳理模块职责尝试修改参数、添加新功能或优化性能在实战中提升Java编程与代码组织能力。1. 从一份俄罗斯方块源码说起为什么我建议你从它开始读很多人第一次想读游戏源码都会挑一个“看起来简单”的项目。俄罗斯方块往往第一个被想到然后被迅速放弃——因为网上流传的版本要么是几百行塞进一个文件的面条代码要么是套了引擎之后只剩胶水逻辑读完什么也学不到。我最近拿到一份 Java 实现的俄罗斯方块源码结构干净没有依赖任何游戏引擎纯 Swing 绘制把“游戏主循环、方块旋转、碰撞检测、消行计分”这四件事拆得清清楚楚。它适合两类人一是刚学完 Java 基础、想找一个能跑起来又能看懂的项目练手的新手二是想自己写个小游戏、但不知道状态管理和渲染循环怎么组织的开发者。这份源码不炫技但每一块都能对应到实际工程里的真实问题。2. 项目结构与技术选型一个不依赖引擎的 Java 桌面游戏怎么搭2.1 目录结构与模块划分拿到源码后先别急着跑把目录扫一遍心里有个地图。这份俄罗斯方块源码的典型结构如下tetris/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/ │ │ │ └── tetris/ │ │ │ ├── Main.java │ │ │ ├── GamePanel.java │ │ │ ├── GameThread.java │ │ │ ├── Tetromino.java │ │ │ ├── Board.java │ │ │ └── ScorePanel.java │ │ └── resources/ │ │ └── block.png └── pom.xml这个划分对应了五个职责Main负责启动窗口GamePanel是主画布GameThread是游戏循环Tetromino管方块形状和旋转Board管网格状态和消行ScorePanel单独显示分数。每个类只做一件事读起来不会迷路。2.2 技术选型为什么是 Swing 而不是 JavaFX源码用的是 Swing不是 JavaFX。这不是偷懒而是有实际考虑的。Swing 从 JDK 1.2 就内置不需要额外依赖pom.xml里除了 JUnit 几乎没有第三方库。对于一份教学性质的源码来说少一层依赖就少一层理解成本。Swing 的JPanel.paintComponent配合Timer或独立线程足够撑起一个 60 帧的方块游戏。常见做法是主循环用Thread.sleep控制节奏渲染统一走repaint()逻辑更新和绘制分离。这份源码就是这么干的。2.3 核心类职责一览类名职责关键方法Main创建 JFrame装配面板mainGamePanel绘制网格、当前方块、下一个方块paintComponentGameThread控制下落速度、游戏状态runTetromino定义 7 种方块形状与旋转rotateBoard维护 20x10 网格检测碰撞与消行checkCollision, clearLinesScorePanel显示分数、等级、行数updateScore这张表建议你贴在编辑器旁边读代码时随时对照。3. 核心模块拆解方块旋转、碰撞检测与消行的代码实现3.1 方块的数据结构用二维数组表示形状俄罗斯方块有 7 种基本形状I、O、T、S、Z、J、L每种形状在不同旋转状态下有不同的占位。源码用二维数组表示public class Tetromino { // 每种方块用 4x4 矩阵表示1 表示有方块0 表示空 private int[][] shape; private int x, y; // 当前方块在棋盘上的左上角坐标 // I 型方块的初始形状 private static final int[][] I_SHAPE { {0, 0, 0, 0}, {1, 1, 1, 1}, {0, 0, 0, 0}, {0, 0, 0, 0} }; public Tetromino(int[][] shape) { this.shape shape; this.x 3; // 从中间开始 this.y 0; } // 顺时针旋转 90 度转置后左右翻转 public void rotate() { int n shape.length; int[][] rotated new int[n][n]; for (int i 0; i n; i) { for (int j 0; j n; j) { rotated[j][n - 1 - i] shape[i][j]; } } shape rotated; } }这里的关键是旋转算法先转置再水平翻转等价于顺时针旋转 90 度。用 4x4 矩阵而不是紧凑数组是为了旋转时不用重新计算边界代价是多了几个空位。参数x和y是方块在棋盘坐标系里的位置旋转只改shape不改x、y位置调整交给碰撞检测后的回退逻辑。3.2 碰撞检测判断能不能移动或旋转碰撞检测是俄罗斯方块里最容易写错的地方。源码的做法是先假设移动再检查是否越界或重叠如果冲突就回退。public class Board { private int[][] grid; // 20 行 10 列0 为空非 0 为已固定方块 private static final int ROWS 20; private static final int COLS 10; // 检查当前方块在指定位置是否合法 public boolean isValidPosition(Tetromino piece, int newX, int newY) { int[][] shape piece.getShape(); for (int i 0; i shape.length; i) { for (int j 0; j shape[i].length; j) { if (shape[i][j] 0) continue; int boardX newX j; int boardY newY i; // 左右越界、底部越界 if (boardX 0 || boardX COLS || boardY ROWS) { return false; } // 与已固定方块重叠 if (boardY 0 grid[boardY][boardX] ! 0) { return false; } } } return true; } }逻辑说明遍历方块的 4x4 矩阵只检查值为 1 的格子。boardY 0的判断是为了允许方块在顶部部分露出时仍然合法。如果任何一格越界或与grid中已有方块重叠返回false。调用方在移动前先试算新坐标合法才真正更新x、y。3.3 消行与计分从底部往上扫描消行的逻辑不复杂但顺序很重要。源码从底部往上扫描遇到满行就删除并把上面的行整体下移。public int clearLines() { int linesCleared 0; for (int row ROWS - 1; row 0; row--) { boolean full true; for (int col 0; col COLS; col) { if (grid[row][col] 0) { full false; break; } } if (full) { // 将 row 以上的所有行下移一行 for (int r row; r 0; r--) { System.arraycopy(grid[r - 1], 0, grid[r], 0, COLS); } // 顶部行清空 Arrays.fill(grid[0], 0); linesCleared; row; // 重新检查当前行因为上面的行已经下移 } } return linesCleared; }参数说明grid是 20x10 的二维数组。System.arraycopy做整行复制比嵌套循环快。row是为了抵消循环的row--让下一次迭代仍然检查同一行位置因为下移后这里可能是新的满行。计分规则通常按一次消除的行数给不同分数源码里是 1 行 100 分、2 行 300 分、3 行 500 分、4 行 800 分。3.4 游戏主循环线程控制下落节奏游戏循环用独立线程而不是 Swing 的Timer因为下落速度需要动态调整等级越高越快。public class GameThread extends Thread { private GamePanel panel; private boolean running true; private int dropInterval 500; // 毫秒 public void run() { while (running) { try { Thread.sleep(dropInterval); } catch (InterruptedException e) { break; } // 尝试下落一格失败则固定方块并生成新方块 if (!panel.moveDown()) { panel.lockPiece(); panel.spawnNewPiece(); panel.clearLines(); } panel.repaint(); } } public void setDropInterval(int interval) { this.dropInterval interval; } }逻辑说明dropInterval控制下落速度初始 500ms每消 10 行减 50ms最低 100ms。moveDown()返回false表示无法继续下落此时把当前方块固定到grid生成新方块再检查消行。repaint()触发GamePanel重绘。注意running标志用于退出线程避免窗口关闭后线程还在跑。4. 跑起来与改起来编译、运行和常见改造点4.1 环境准备与编译命令这份源码是标准 Maven 项目需要 JDK 8 或以上。如果你没有 Maven也可以直接用javac编译。# 方式一Maven mvn clean compile mvn exec:java -Dexec.mainClasscom.tetris.Main # 方式二手动编译 cd src/main/java javac com/tetris/*.java java com.tetris.Main注意手动编译时资源文件block.png需要复制到com/tetris/目录下否则图片加载会报空指针。Maven 会自动处理资源路径。4.2 运行效果与操作说明启动后会出现一个 300x600 的窗口左边是 10x20 的游戏区右边是分数面板。操作键左右箭头移动上箭头旋转下箭头加速下落空格直接落底。源码里键盘监听在GamePanel的KeyAdapter中实现每个按键对应调用moveLeft()、moveRight()、rotate()、hardDrop()。4.3 常见改造点从能跑到好用拿到源码后最常改的几个地方改下落速度曲线在GameThread里调整dropInterval的递减逻辑比如每消 5 行减 30ms。加暂停功能在GamePanel里加一个paused标志GameThread循环里判断暂停时Thread.sleep(100)空转。加下一个方块预览GamePanel里多画一个 4x4 区域从Tetromino工厂里提前取一个形状。改配色paintComponent里每个方块的颜色由grid里的值决定改颜色映射表即可。这些改动都不需要动核心逻辑适合作为二次开发的起点。5. 避坑与排查跑这份源码时容易翻车的几个地方5.1 窗口一闪而过或白屏现象运行后窗口出现但立刻消失或者一片白。原因通常是Main里没有设置setDefaultCloseOperation或者GamePanel的paintComponent里抛了异常被吞掉。解决在Main里加frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE)并在paintComponent开头加super.paintComponent(g)否则 Swing 不会清空背景。5.2 方块旋转后卡在墙里现象按上箭头旋转方块直接嵌进左右边界或底部。原因旋转后没有做碰撞检测回退。解决在rotate()调用后立即用isValidPosition检查不合法就旋转回去。常见做法是尝试左右微移wall kick但这份源码只做了简单回退够用。5.3 消行后分数不更新现象行消了但分数面板没变。原因clearLines()返回消除行数但调用方忘了把返回值传给ScorePanel.updateScore()。解决在GameThread里把panel.clearLines()的返回值接住调用scorePanel.addScore(lines)。5.4 线程退出后报 IllegalThreadStateException现象关闭窗口后控制台报错。原因GameThread的running标志没有在窗口关闭时置为false线程还在跑但panel已经销毁。解决在Main里加WindowListenerwindowClosing时调用gameThread.stopRunning()把running设为false并interrupt()。5.5 图片资源加载失败现象方块显示为黑色或报NullPointerException。原因getClass().getResource(block.png)的路径不对。解决确认block.png在 classpath 根目录或与GamePanel同包。Maven 项目放在src/main/resources/下手动编译时复制到com/tetris/。6. 二次开发技巧把这份源码改成你自己的游戏这份源码最值钱的地方不是俄罗斯方块本身而是它把“网格状态实时循环输入响应”这套模式写清楚了。你完全可以拿它当模板改成贪吃蛇、推箱子、甚至一个简单的战棋 demo。我自己的习惯是先不动核心逻辑只改Tetromino的形状定义和Board的网格尺寸跑通一个“变体俄罗斯方块”比如 15x15 的方形棋盘、方块形状改成不规则多边形。这一步能帮你确认自己真的理解了坐标系统和碰撞检测。具体改造时我一般会先抽一个ShapeFactory接口把Tetromino的创建逻辑从GamePanel里解耦出来。这样加新形状不用改渲染代码。然后给Board加一个reset()方法方便重开一局。最后把GameThread里的dropInterval抽成配置项从config.properties读改速度不用重新编译。验证方法很简单每改一个模块先跑一局看有没有崩溃再用System.out.println打印关键状态当前方块坐标、网格快照、分数确认逻辑符合预期。别一上来就大改俄罗斯方块的边界条件比看起来多尤其是旋转和消行的交互。从那以后我每次拿到一份小游戏源码都强制自己先跑通、再改一个参数、最后加一个小功能三步走完才敢说“看懂了”。希望这份俄罗斯方块的拆解能帮你省下自己摸索的时间直接上手改出点自己的东西。本文还有配套的精品资源点击获取

Java俄罗斯方块源码解析：游戏主循环、碰撞检测与消行实现

相关推荐

NLP与无人船：从自然语言指令到自主靠泊的完整技术链路

施耐德平台API设备列表获取与同步实战指南

GPU到国产AI加速卡迁移实战：推理服务适配与性能调优全记录

更多资讯

MTT AIBOOK深度实测：专为AI Agent与多Agent协作打造的生产级运行平台

快恢复二极管FRD选型指南：从反向恢复时间到产线布局的行业调研拆解

机械原理试讲课件拆解：19页PPT讲透自由度计算与运动副分类

lingbot-map：移动机器人地图管理模块的设计与工程实践

自建知识工作插件集：从采集到检索的本地自动化方案

拆解“2000万只鹅已就位”：爆品预热背后的预期管理与营销逻辑

今日更新

微信云开发旅游小程序实战：LBS打卡+UGC社交全栈方案

金融AI代理平台核心拆解：从多代理协作到财报分析实战

基于大数据的智慧旅游推荐与可视化平台架构实践

本周精选

金融AI落地指南：从调研报告到技术选型与工程实践

大模型上下文成本与注意力优化技术深度解析——为何O(n²)平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测

基于GMM的语音识别系统原理与MATLAB实现详解

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？