Java课程设计俄罗斯方块：技术选型、核心算法与打包验收

简介基于Java实现的俄罗斯方块课程设计完整工程面向需要完成Java课设的高校学生、刚接触图形界面编程的开发者以及想通过经典小游戏强化面向对象思维的编程爱好者。压缩包内含41个文件以Java源码和编译后class文件为主附带课程设计报告doc文档、项目配置与工程文件便于对照阅读代码、运行调试与撰写报告。整个资源约744KB结构紧凑适合作为Java图形界面、事件处理与游戏逻辑综合练习的范本。已有1102人学习下载。内容涵盖方块类设计、旋转与碰撞检测、下落控制、消行计分和游戏结束判定等完整实现课程设计报告进一步说明项目背景、设计决策、测试过程与改进方向帮助读者理解JavaFX/Swing界面编程、面向对象模块划分以及时间驱动更新机制。既能满足课设答辩需求也可作为从基础语法迈向完整小游戏开发的进阶素材。1. 为什么要做这个 Java 课设俄罗斯方块不是“太简单”而是“刚好够用”如果你刷到“Java课设-俄罗斯方块.zip”这个词大概率不是想抄代码而是想知道这套课设到底怎么选、怎么写、怎么打包成 zip 交上去不出问题。Java 课程设计最怕的不是题目难而是题目太简单显得水或者太复杂做不完。俄罗斯方块刚好卡在中间逻辑上要处理形状定义、旋转、碰撞检测、消行计分界面上要处理渲染和按键响应视觉上能直接看出“游戏能玩”答辩时也好演示。比起学生管理系统、图书管理系统这类“增删改查”项目评委更容易被一个能交互的桌面游戏打动。这条链路里真正决定成绩的不是游戏本身而是三件事用什么技术栈写Swing/JavaFX、核心逻辑写得多工整旋转与碰撞的算法设计、提交的 zip 包能不能在对方电脑上一键跑起来。本文就按这三个方向展开给出能照做的实现方案和我在课设指导里反复见到的坑。2. 先想清楚技术栈Swing、JavaFX 还是控制台2.1 三种方案怎么选俄罗斯方块本质是一个二维格子上的“形状移动 堆叠消除”游戏对图形渲染要求很低对事件响应要求中等。常见做法有三条路线方案上手成本界面效果答辩印象适用人群控制台/Curses最低字符拼格子偏弱时间严重不足Swingjavax.swing中桌面窗口、色块清晰较好绝大多数课设JavaFX偏高动画流畅、样式现代最好愿意多花时间学布局我给课设同学的建议一致优先选 Swing。原因不是 JavaFX 不好而是课设的验收机环境不可控——Swing 是 JDK 自带的只要装了 JDK 就能编译运行不用额外配 JavaFX SDK、不用处理模块化配置。JavaFX 在 JDK 8 之后从标准 JDK 里拆了出去对方机器上没装对应的 SDK你的程序一启动就报错这是课设翻车现场第一名。控制台方案我基本不推荐除非你连 Swing 的事件分发都来不及学。字符界面的俄罗斯方块虽然逻辑也能写出来但“界面效果”这一项在评分表里通常占 15-20 分这部分白丢了不划算。2.2 项目骨架与核心类划分不管最后选 Swing 还是 JavaFX游戏逻辑本身和界面要解耦。最初写的时候很容易把方块坐标、落地方块、消除判定全部堆进 JPanel 的 paintComponent 里最后逻辑改一行界面崩一片。我一般这样拆分Tetromino定义 7 种形状的造型与旋转GameBoard管理 10×20 的棋盘状态、碰撞检测、消行GamePanel负责绘制与按键交互TetrisApp程序入口创建窗口一个可以立即用的入口代码如下public class TetrisApp { public static void main(String[] args) { JFrame frame new JFrame(Java课设-俄罗斯方块); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); GamePanel panel new GamePanel(); frame.add(panel); frame.pack(); frame.setLocationRelativeTo(null); frame.setVisible(true); panel.startGame(); } }逻辑说明main方法里做的事情是创建主窗口、装配游戏面板、让窗口居中显示并启动游戏。注意pack()必须在add(panel)之后调用因为GamePanel如果覆写了getPreferredSize()pack()会按面板的期望大小来调整窗口尺寸顺序反了窗口可能缩成一团。setLocationRelativeTo(null)表示窗口居中这是桌面程序最常见的细节不少同学忽略后窗口出现在屏幕角落演示时体验很差。参数说明窗口大小由GamePanel.getPreferredSize()决定常见选择是 300×600 的棋盘区加一个 160 宽的右侧信息区。JFrame.EXIT_ON_CLOSE表示关闭窗口即结束进程课设程序用这个最省心不用处理窗口关闭事件。3. 核心逻辑怎么写形状、旋转、碰撞与消行3.1 用坐标法而不是 4×4 矩阵定义方块俄罗斯方块有 7 种标准形状I、O、T、S、Z、J、L。最直观的做法是用 4×4 的 boolean/int 二维数组定义每个形状的像素点。这种写法用起来简单但旋转时要处理 4×4 矩阵整体翻折而且存在“旋转后形状位置漂移”的问题。更好的常见做法是“坐标法”每个形状定义为一个基准位置加上若干相对坐标旋转时对坐标做变换。比如“T”形方块可以定义为public class Tetromino { private int[][] shape; // 当前形状的坐标数组每行是 [row, col] private int colorIndex; // 用于界面取色的序号 private int row, col; // 形状当前在棋盘中的左上角位置 public Tetromino(int[][] shape, int colorIndex) { this.shape shape; this.colorIndex colorIndex; this.row 0; this.col 3; // 默认从棋盘顶部中间开始 } public int[][] getShape() { return shape; } public int getRow() { return row; } public int getCol() { return col; } }逻辑说明shape里的坐标都是相对坐标比如new int[][]{{0,1},{1,0},{1,1},{1,2}}表示 T 形。真正画到棋盘上时实际单元格位置是(row r, col c)其中(r, c)是相对坐标。这套结构的优势是旋转变换只需要处理小规模的相对坐标而不用关心方块在棋盘上的绝对位置。参数说明初始col 3是让方块出现在棋盘水平方向的中间附近。10 列棋盘的索引是 0-9宽度为 3 的形状从第 3 列开始左右各有 3 列余量。3.2 旋转为什么容易写歪绕点与墙踢旋转是俄罗斯方块中出 bug 最多的地方。常见做法是让每个形状围绕自己的中心旋转或者对每个形状预置 4 个旋转形态每次取下一个。预置形态法更简单直观我一般用坐标变换法public int[][] rotateMatrix(int[][] src) { int rows src.length; int cols src[0].length; int[][] dest new int[cols][rows]; for (int r 0; r rows; r) { for (int c 0; c cols; c) { dest[c][rows - 1 - r] src[r][c]; } } return dest; }逻辑说明这是标准的顺时针旋转公式它把行下标映射到列下标并做一次镜像翻转。调用方拿到dest后先基于“旋转后的相对坐标”做一次碰撞检测如果被墙挡了或者碰到已经落地的方块就需要做位置修正。这里的做法是把形状整体向左或向右移动一列再检测最多试探 2-3 次还不行就放弃这次旋转。这个“旋转后再偏移”的过程专业一点叫“墙踢wall kick”是让方块在贴墙时也能正常旋转的关键。参数说明rotateMatrix这个方法对非方阵同样适用但在俄罗斯方块的标准形状里I 形和 O 形是 4×4 和 2×2 的矩阵其余都是 3×3。O 形是正方形旋转前后视觉完全一样可以直接跳过旋转省一次判断。3.3 碰撞检测所有逻辑的地基碰撞检测的思路很直接把一个形状的每个相对坐标换算成棋盘绝对坐标检查是否越界是否落在已被占用的格子上。public boolean canMove(int[][] shape, int newRow, int newCol) { for (int[] cell : shape) { int r newRow cell[0]; int c newCol cell[1]; if (r 0 || r ROWS || c 0 || c COLS) { return false; } if (board[r][c] ! 0) { return false; } } return true; }逻辑说明ROWS和COLS是棋盘常量常见的是 20 行 × 10 列。board是二维 int 数组0 表示空格非 0 表示已落定的方块。移动、旋转、下落之前都先调用这个方法判断是“有效”还是“无效”。注意r 0这行判断对应的是方块从顶部生成时超出棋盘上边界的情况这个边界很多初学者会漏掉导致方块卡在窗口顶部掉不下来。参数说明newRow和newCol是本次移动的目标位置不是当前位置。这个函数的命名值得记一下——它只问“能不能去”不负责“真正去”任何修改位置的操作必须先验证再执行。3.4 消行与计分先消行还是先掉落消行逻辑看起来简单但有一些顺序坑public int clearLines() { int lines 0; for (int r ROWS - 1; r 0; r--) { boolean full true; for (int c 0; c COLS; c) { if (board[r][c] 0) { full false; break; } } if (full) { for (int k r; k 0; k--) { board[k] Arrays.copyOf(board[k - 1], COLS); } board[0] new int[COLS]; r; // 当前行下降后继续检查同一行 lines; } } return lines; }逻辑说明从最底行往上检查发现满行后把上面的行整体下移一行顶部补一个新空行。r是让循环重新检查当前这行——因为上一行被复制下来了原先这一行的位置现在放的是新的内容需要再检查一次。很多同学漏掉这行导致连续两行同时消除时只消掉一行。参数说明计分规则按“1 行 100 分2 行 300 分3 行 500 分4 行 800 分”来写就可以这是游戏的常见做法。Arrays.copyOf的用法是复制整行的内容注意COLS是列数。4. 界面与交互绘制、按键、下落节奏4.1 用 JPanel 绘制棋盘与当前方块Swing 的绘图就是覆写paintComponent(Graphics g)。这里的关键是把“游戏数据”和“绘制代码”分开paint 方法只负责按GameBoard的数据画格子至于这些数据是怎么来的绘制层不关心。Override protected void paintComponent(Graphics g) { super.paintComponent(g); drawBoard(g); drawCurrentTetromino(g); drawInfo(g); } private void drawBoard(Graphics g) { for (int r 0; r ROWS; r) { for (int c 0; c COLS; c) { int colorIndex board.getCell(r, c); if (colorIndex 0) { g.setColor(colors[colorIndex]); g.fillRect(c * CELL_SIZE, r * CELL_SIZE, CELL_SIZE, CELL_SIZE); } } } }逻辑说明board.getCell(r, c)返回 0 或某个颜色索引0 表示空格。colors数组存放 7 种方块颜色用colorIndex映射可以在不改变绘制逻辑的前提下统一处理已落地块和当前方块。这个设计的好处是界面层代码量少绘制逻辑只理解“颜色索引”。参数说明CELL_SIZE常见的取值是 24 或 30 像素。格子尺寸影响窗口整体大小同时也影响性能——对 Swing 来说 24 像素与 30 像素几乎没有性能差异但如果你用的高分屏设备窗口可能偏小后面第 5 章会讲缩放问题。4.2 刷新与下落Timer 还是新线程游戏循环两种写法javax.swing.Timer或new Thread。课设内我强烈推荐 Timer因为 Swing 是单线程模型所有界面更新都要在事件分发线程EDT上完成。Timer 的回调天然跑在 EDT 上而自建 Thread 里直接调用repaint()会有线程安全问题。Timer timer new Timer(400, e - { if (!paused !gameOver) { if (board.canMove(current.getShape(), current.getRow() 1, current.getCol())) { current.moveDown(); } else { board.merge(current); int lines board.clearLines(); score lines * 100; spawnNext(); } repaint(); } }); timer.start();逻辑说明每 400 毫秒触发一次“下落一步”的逻辑。能下移就moveDown()不能就合并进棋盘、消行、生成新方块。repaint()只是请求重绘Swing 会把多个重绘请求合并到同一帧不用担心性能问题。参数说明400是下落间隔单位是毫秒。你可以把它做成跟随分数变化的值比如Math.max(100, 400 - level * 30)每消 4 行升一级提速一次。注意间隔不能低于 80 毫秒左右否则手动操作根本跟不上节奏反而显得游戏“失控”。4.3 按键响应焦点问题与按键映射按键监听的第一大坑就是“按了没反应”。原因是JFrame默认焦点在某个按钮上或者面板没有请求焦点。解决方式是在窗口显示后调用panel.setFocusable(true)和panel.requestFocusInWindow()。panel.setFocusable(true); panel.addKeyListener(new KeyAdapter() { Override public void keyPressed(KeyEvent e) { switch (e.getKeyCode()) { case KeyEvent.VK_LEFT: tryMove(0, -1); break; case KeyEvent.VK_RIGHT: tryMove(0, 1); break; case KeyEvent.VK_DOWN: tryMove(1, 0); break; case KeyEvent.VK_UP: rotate(); break; case KeyEvent.VK_SPACE: hardDrop(); break; case KeyEvent.VK_P: paused !paused; break; } } });逻辑说明tryMove内部先做canMove碰撞检测通过才更新坐标。space对应“硬降”——直接把方块落到最底部并立刻合并。p键做暂停注意暂停时 Timer 不要停靠paused标志位跳过逻辑处理这样重绘仍能继续界面不会出现卡死感。参数说明推荐把“左/右/下/旋转/硬降/暂停”全部用键盘实现不要用按钮控件因为按钮点按的游戏体验很差而且会抢占 JFrame 的焦点焦点问题会变成连锁的。如果你希望支持“软降”和“硬降”两种操作可以把VK_DOWN设为一次下移一格把空格设为直接落底这是常见做法。4.4 下一个方块预览与右侧信息区俄罗斯方块的标准功能里包含“下一块预览”这个功能的实现代价很低直接提升完成度。做法是在主面板右侧留一块 160 像素的区域把nextTetromino按小号格子画出来private void drawNextBox(Graphics g) { int[][] shape nextTetromino.getShape(); g.setColor(colors[nextTetromino.getColorIndex()]); for (int[] cell : shape) { int x boardRight 20 cell[1] * 20; int y 80 cell[0] * 20; g.fillRect(x, y, 20, 20); } }逻辑说明boardRight是棋盘右边缘的 x 坐标所有右侧信息区的内容都以它为基准定位避免魔术数字散落各处。预览区用 20 像素小格子就当作一个“预览棋盘”。同时右侧可以画分数、等级、消行数这些信息在repaint()里一并重绘即可。5. 课设高频翻车点这份避坑清单能救回两位数失分5.1 双击 zip 里的 jar 没反应现象把项目打包成 zip 发给同学对方解压后双击.jar文件桌面毫无反应双击多次也没用控制台也没有输出。原因.jar不是双击就能运行的。需要 manifest 文件里声明Main-Class并且运行环境要能识别 jar 的打开方式。课设机器上往往没配置 jar 关联到javaw.exe双击自然无效。更麻烦的情况是对方压根没装 JRE连 java 命令都不存在。解决不要依赖双击 jar。在 zip 包里放一个 Windows 批处理启动脚本双击.bat就能拉起程序。脚本只有一行核心命令java -jar Tetris.jar如果对方机器 JDK 版本偏老可以加-d64之类的参数但一般没必要。真正要提醒的是zip 包里的所有文件放在同一个目录下不能出现Tetris文件夹里嵌套另一个Tetris文件夹的情况路径多一层很可能导致 jar 找不到资源文件。5.2 旋转后方块位置对不上现象方块在中间旋转正常一到贴墙的地方旋转就“穿模”或者旋转后形状突然跳了一大格看起来像瞬移。原因旋转公式本身没问题但形状的包围盒尺寸在旋转前后变了。一个 3×3 的形状旋转后包围盒还是 3×3但如果坐标里有负值或者形状不对称旋转后相对坐标的最小值不为 0导致换算到棋盘时的基准点错位。解决每次旋转得到新坐标后做一次归一化处理int minRow Integer.MAX_VALUE, minCol Integer.MAX_VALUE; for (int[] cell : newShape) { minRow Math.min(minRow, cell[0]); minCol Math.min(minCol, cell[1]); } for (int[] cell : newShape) { cell[0] - minRow; cell[1] - minCol; }逻辑说明旋转后先把所有坐标平移到非负区间保证形状的包围盒从(0,0)开始这样和最初定义形状时用的坐标系完全一致不会出现视觉偏移。5.3 消行时棋盘整体“噗”了一下现象同时消除两行或多行时底部只消掉一行或者消掉后出现格子串位。原因这就是第 3 章里讲过的问题——消行后循环变量r没有回调。多行同时满时如果检测顺序从下往上下行消掉后上方所有行整体下移当前索引位置变成了新行必须重新检查这个索引否则会漏检。解决按第 3 章的写法在高处r或者改用另一种常见写法——先找出所有满行的行号再从下往上逐行删除。推荐后者代码更直观public int clearLines() { ListInteger fullRows new ArrayList(); for (int r 0; r ROWS; r) { boolean full true; for (int c 0; c COLS; c) { if (board[r][c] 0) { full false; break; } } if (full) fullRows.add(r); } for (int r : fullRows) { for (int k r; k 0; k--) { board[k] Arrays.copyOf(board[k - 1], COLS); } board[0] new int[COLS]; } return fullRows.size(); }逻辑说明先收集所有满行统一消除避免边消边移行导致的索引错乱。注意这里从下往上处理不需要因为每次删掉一行后上面的行索引自动减一循环依然能正确覆盖。5.4 游戏结束的判断写错了位置现象新方块生成后就立即 game over但明明棋盘中间还空着。原因判断条件是“新方块不能放在初始位置”这个逻辑没问题但很多人把判断写成“当前方块不能下落”导致移行后误判。正确判断点应该是当spawnNext()生成新方块后检测它的初始位置是否与已有方块冲突。public void spawnNext() { current nextTetromino; nextTetromino randomTetromino(); if (!canMove(current.getShape(), current.getRow(), current.getCol())) { gameOver true; } }逻辑说明新的方块放在棋盘顶部如果这个位置已经被占用说明某列已经堆到了顶游戏结束。注意这个判断必须在current赋值之后做用canMove检测而不是用“当前方块能否下移”来判断。5.5 打包 zip 前漏了资源文件现象在你电脑上运行正常换台电脑后图片不显示、音效不播放或者运行直接报ClassNotFoundException。原因资源文件是按照绝对路径或File方式读取的。比如用new ImageIcon(res/bg.png)这里的“相对路径”是相对于工作目录的解压到不同位置工作目录就变了资源当然找不到。正确做法是把图片打包进 jar 里使用类路径访问InputStream is TetrisApp.class.getResourceAsStream(/bg.png); ImageIcon icon new ImageIcon(ImageIO.read(is));逻辑说明getResourceAsStream从 classpath 根目录读取资源只要bg.png在编译后进入 jar 的根目录在什么机器上运行都通用。这是课设最容易忽略、又最影响评分稳定性的细节。6. zip 交付与验收让你在演示时不再手忙脚乱6.1 一份能“解压即用”的 zip 应该长什么样常见的做法是项目源码、可运行 jar、启动脚本、说明文档、数据库脚本如果有按固定顶层目录放入一个文件夹再压缩成 zip。俄罗斯方块这种纯桌面项目推荐这样的包内结构Tetris_课设/ ├── src/ # 源码评委可能会看 ├── Tetris.jar # 可直接运行的打包产物 ├── 启动游戏.bat # 双击运行 ├── 使用说明.txt # 运行环境、操作方式 └── 设计文档.docx # 课设报告设计文档不一定要多厚但要包含类图、核心算法说明、游戏规则、运行截图。使用说明里写清楚“需要 JDK 8 及以上”这能避免大量运行环境相关的追问。6.2 用命令打包 jar 与 zip如果你的工程是 IDE 管理的比如 IntelliJ IDEA 的Artifacts功能可以直接打包。命令行方式也值得掌握因为很多课设现场机器没装 IDE但一定有 JDK。把编译好的.class文件按包结构放好然后执行jar cvfe Tetris.jar com.example.tetris.TetrisApp -C out .参数说明c创建新 jarv输出详细日志f指定输出文件名e指定入口类-C out .表示把out目录下的所有内容作为 jar 根目录。注意入口类要写全限定类名不是main方法所在类的简单名。打包完成后用jar tf Tetris.jar查看 jar 内文件列表确认TetrisApp.class在主目录结构顶层存在。生成 zip 同样可以用命令行zip -r Tetris_课设.zip Tetris_课设/或 Windows 下右键“压缩为 zip”。如果你要发送给对方压缩格式用 zip不要用 7z 或 rar——zip 在 Windows、macOS、Linux 下都有原生支持。6.3 验收三步走在自己电脑上模拟“陌生环境”我指导课设时总会让学生做一次“交付模拟”把 zip 发到另一台电脑或者在你自己的电脑上解压到与源码目录完全无关的位置然后按这三步走一遍第一步双击“启动游戏.bat”确认能正常出窗。如果 jar 运行失败看控制台报错是UnsupportedClassVersionError多半是 JDK 版本太低需要把项目编译 target 改成较低的 Java 版本是ClassNotFoundException多半是资源问题检查 classpath 访问方式。第二步玩三回合先按左键再按旋转键再按硬降键确认响应正常。三回合是为了覆盖“旋转后位置准不准”和“消行后格子稳不稳”。第三步关闭窗口再启动一次确认不会因为残留进程导致端口占用或窗口打不开。Swing 程序多开没问题但如果加了ServerSocket之类的通信模块就要注意端口释放问题。6.4 答辩时怎么演示才能拿高分演示顺序有讲究。先讲玩法规则简单评委一眼能懂再讲架构类怎么划分、为什么把逻辑和界面分离最后展示一个具体的难点——比如旋转时的墙踢、消行时的索引处理、碰撞检测的边界条件。这些是评分表里“设计思路”和“程序结构”两项的得分点。我自己的习惯是准备两个版本一个正常速度一个调成极慢速度。慢速版用于讲清楚“当前方块移动时程序是如何判断能不能走这一步的”——评委看到你一步步拆解碰撞检测比看到你一秒钟消四行更有意义。对项目代码量不大的课设来说把过程讲清楚远比结果炫酷重要。这种“先让程序跑起来再把表面功夫做足”的思路在整个 Java 课设里都通用。俄罗斯方块是我带过的课设里翻车率最低的一档只要你把旋转、碰撞和打包这三关走通成绩的下限就已经稳住了。希望这篇文章能帮你一次交出一份自己满意的课设作业。本文还有配套的精品资源点击获取