简介这是一份基于Python语言实现的俄罗斯方块小游戏源码包主要面向Python初学者、游戏开发爱好者以及需要课程设计的同学。压缩包内共包含4个文件以1个核心Python脚本为主另附2个wav格式游戏音效和1个mp3背景音乐整体大小仅6MB轻量易用。代码采用模块化方式组织覆盖棋盘布局、方块生成与旋转、自动下落、碰撞检测、消行得分等经典俄罗斯方块核心机制并集成音效反馈与背景音乐与网上零散代码不同这份压缩包将程序与音效素材打包完整下载即可运行体验。目前该资源已有322人学习下载说明其在学习参考方面具备一定热度。读者不仅可以直接运行游玩还可以在此基础上二次开发增加等级加速、最高分记录、暂停与开始界面等个性化功能是理解游戏循环和Python编程逻辑的实用案例。 俄罗斯方块这玩意儿大概是游戏开发里最经典的入门项目了。逻辑不复杂但麻雀虽小五脏俱全从数据建模、碰撞检测到界面渲染一个完整的小游戏该有的环节它全都有。用 Python 写一个能跑起来的版本比想象中要费点心思但收获也是实打实的——尤其适合刚学完语法、想找个项目练手的朋友。这篇文我会从零开始把整个实现思路、核心代码、还有我实际踩过的坑都捋一遍。不是那种丢一份完整代码让你跑完就完事的教程而是把“为什么这么写”讲清楚这样你拿到任何一块逻辑都能自己改、自己扩展。1. 整体方案与核心设计思路先说我最终选定的技术方案Python 3.10 pygame 2.x。为什么用 pygame因为它就是 Python 生态里做 2D 小游戏最省事的库窗口创建、事件处理、图形绘制、帧率控制全都帮你封装好了你不用去碰底层的窗口 API 或者图形渲染逻辑能专注在游戏逻辑本身。游戏的核心数据模型其实特别朴素就三样东西一个二维数组表示的网格棋盘、一个当前方块、一个下一个方块。网格负责记录已经固定的方块位置当前方块负责移动和旋转下一个方块只是用来预览顺便让玩家有点盼头。我建议把代码拆成三个模块而不是全部塞进一个文件里tetris.py定义方块形状、颜色、旋转逻辑game.py定义游戏类负责网格、碰撞、消行、计分main.py主循环处理输入、驱动游戏逻辑、渲染画面初始版本可以把三者合并到一个文件里跑通但拆开更有利于你后续加功能——比如加音效、加等级加速、加“幽灵方块”预览落点。我实测下来拆开写之后的调试体验会舒服很多因为每个模块的职责边界清晰出问题能快速定位。1.1 网格与坐标系的设定俄罗斯方块的标准网格是 10 列 × 20 行列数多了游戏太宽松少了又挤得慌10×20 是多年验证下来的黄金比例。我用一个二维列表来表达网格每个元素要么是0空要么是颜色值该位置已被方块占用。这里有个非常容易踩的坑网格的行列索引和屏幕坐标的方向关系。我习惯把grid[row][col]定义成第row行、第col列也就是先纵后横。但在 pygame 的坐标系里画矩形用的是(x, y)先横后纵。如果不做转换画出来的方块会“翻转”或者错位。所以我在写draw函数时会明确做一次换算x col * BLOCK_SIZEy row * BLOCK_SIZE每次画之前都想清楚自己在操作哪个坐标系否则很容易画出歪七扭八的东西。1.2 方块形状的数据建模七种经典方块I、O、T、S、Z、J、L的数据模型也值得琢磨。最直观的表示方式是用 4×4 或者 3×3 的布尔矩阵包含方块形状的地方为1其余为0。比如 T 型方块可以表示为[0, 1, 0], [1, 1, 1], [0, 0, 0]每个方块我还会配一个颜色元组(r, g, b)比如 T 型方块用紫色(128, 0, 128)I 型用青色(0, 255, 255)。这个颜色不只是好看调试时也能靠颜色快速判断当前操作的是哪个方块。所有方块统一存在一个字典或者列表里每种方块附带它的 spawn 位置生成位置。我实测下来I 型方块因为长度是 4它的生成位置需要单独处理否则一出生就顶到左边界或者右边界这种情况是新手最容易忽略的。2. 七种方块的表示与旋转算法这节是俄罗斯方块实现里最值得花时间琢磨的部分。旋转看似简单但牵涉到坐标系变换和边界条件写不好就会出现“方块旋转后位置偏移”或者“旋转后穿墙”的诡异现象。2.1 旋转矩阵与坐标变换先聊数学基础。二维平面上把一个点绕原点顺时针旋转 90 度变换公式是新x 原y 新y -原x但方块矩阵的旋转不能直接套这个公式因为矩阵的“原点”在左上角行号向下增长跟数学坐标系的 y 轴方向是反的。我实际用的是“转置 行反转”的组合拳来实现顺时针旋转先对矩阵做转置行列互换再把每一行反转这个操作的直观理解是把矩阵竖过来再左右翻一下形状就会顺时针转动 90 度。代码实现很简洁def rotate_clockwise(matrix): return [list(row) for row in zip(*matrix)][::-1]zip(*matrix)做转置[::-1]做行反转。实测对七种方块都适用无需单独处理。2.2 旋转后位置校正旋转时最容易出的 bug 是方块靠墙时一旋转旋转后的形状有一部分超出了网格边界或者叠到了已经固定的方块上面。最简单的处理方式是“尝试旋转失败就不转”但这会让玩家在靠墙时完全无法旋转操作手感很差。业界标准的做法是“墙踢”Wall Kick。核心思路是旋转后如果发生碰撞就把方块分别向左右平移 1 格、2 格再尝试直到找到一个合法位置。如果所有偏移都失败才放弃这次旋转。这个机制只加了几行代码但手感会天差地别def try_rotate(grid, block): rotated rotate_clockwise(block.shape) for dx in (0, -1, 1, -2, 2): if not collides(grid, block.x dx, block.y, rotated): block.shape rotated block.x dx break我加了从 0 到正负 1、2 的偏移序列基本覆盖了靠墙旋转的常见场景。注意偏移顺序有讲究先试原位再试左右各 1 格最后才试 2 格。因为大多数情况下原位就能放下这样可以减少不必要的计算。2.3 碰撞检测的判定条件碰撞检测的规则其实很简单方块矩阵里的每个1对应的网格位置要么出了网格边界左、右、下要么网格里已经有固定方块。任何一条满足就算碰撞。这里有个性能细节没必要检查方块 4×4 矩阵里的所有 16 个位置只需要检查矩阵里值为1的位置。你可以预先做一个坐标列表比如方块在矩阵里的那些非零格子的相对偏移移动时只遍历这个列表把(x col, y row)换算成网格坐标去查效率更高而且逻辑更清晰。网格 200 格方块最多 4 格这种规模下性能差异不大但代码可读性会好很多。我实际写代码时用了一个更简单的方案先判断边界条件x 是否小于 0、x 是否超过 10、y 是否超过 20再判断是否和已固定的方块重叠。因为网格本身很小这种顺序判断在最坏情况下也只有 4 次网格查询完全够用。3. 完整实现步骤与关键代码解析先说环境准备。确保你本机装好了 Python 3.10 或更高版本然后用 pip 把 pygame 装进来pip install pygame如果你用的编辑器是 VS Code建议在项目根目录建一个.venv虚拟环境再装依赖不然全局环境装多了容易跟其他项目冲突。这个习惯我建议从一开始就养成别等出了依赖冲突再后悔。3.1 游戏类的骨架设计我用一个Game类来封装所有游戏状态。初始化时做这几件事创建 20×10 的全零网格、随机选一个当前方块和下一个方块、初始化分数和游戏结束标记。核心属性就五个grid、current_block、next_block、score、game_over。class Game: def __init__(self): self.grid [[0] * COLS for _ in range(ROWS)] self.current_block random_block() self.next_block random_block() self.score 0 self.game_over False注意一个 Python 的老坑[[0] * COLS] * ROWS这样写是不对的因为乘法创建的是同一个列表的引用改一行会带动所有行变化。必须用列表推导式[[0] * COLS for _ in range(ROWS)]创建一个全新的二维列表。这个坑我当年踩得莫名其妙排查了半天才发现是引用共享的问题这里先帮你排掉。3.2 游戏主循环的三段式结构pygame 的主循环其实是非常固定的三段式处理事件、更新状态、渲染画面。对应到俄罗斯方块就是读取键盘输入、尝试移动或旋转方块、让方块自动下落、检查消行、再画出所有东西。while not game.game_over: for event in pygame.event.get(): if event.type pygame.QUIT: run False if event.type pygame.KEYDOWN: if event.key pygame.K_LEFT: game.move(-1, 0) elif event.key pygame.K_RIGHT: game.move(1, 0) elif event.key pygame.K_DOWN: game.move(0, 1) elif event.key pygame.K_UP: game.try_rotate() elif event.key pygame.K_SPACE: game.hard_drop() game.update() game.draw(screen) pygame.display.flip() clock.tick(60)pygame.display.flip()负责把画好的内容真正显示到屏幕上而clock.tick(60)保证帧率稳定在 60 FPS别小看这两行少了它们游戏画面会撕裂或者跑得飞快。3.3 方块的固定与消行逻辑方块落到不能继续下落时要做两件事把方块写进网格然后检查有没有满行需要消除。写进网格就是把方块矩阵里的1对应的坐标填上颜色值。消行逻辑很有意思。很多人的第一反应是“从上往下判断哪些行满了然后一行一行删掉”。但 Python 的列表提供了更优雅的做法遍历所有行把不满的行保留下来然后在列表头部补充相应数量的空行。这样一次遍历就能搞定消行而且不会出现删除中间行导致索引错乱的问题def clear_lines(self): new_grid [row for row in self.grid if any(cell 0 for cell in row)] lines_cleared ROWS - len(new_grid) for _ in range(lines_cleared): new_grid.insert(0, [0] * COLS) self.grid new_grid self.score lines_cleared * 100这里any(cell 0 for cell in row)是判断“这行是不是还有空位”如果有空位就保留满行就被自然过滤掉。insert(0, ...)在头部插入新行模拟上方的新方块掉下来。计分规则我用了最简单的方式消除 n 行得 n × 100 分实际游戏可以再细化成 100、300、500、800 的阶梯计分看你喜好。顺带一提硬降hard drop的实现当玩家按下空格键时让方块一路下落到底。用 while 循环反复执行“尝试下移失败就固定”然后立即固定方块并切换到下一个方块。手感上要保留一次 soft drop 的加分一般加 1 分让追求极限分数的玩家有得玩。3.4 渲染与画面绘制绘制的逻辑分三层背景网格线、已固定的方块、当前下落的方块。背景网格用灰色细线画出 10×20 的格子让玩家对位置有参考。已固定方块遍历网格值不为 0 的位置画对应颜色的实心矩形。当前下落方块则根据它的坐标和形状矩阵画在网格上方通常再加一个边框让它的轮廓更清晰。这里有个体验优化我建议把“下一个方块”的预览画在游戏区域右侧这样玩家可以提前规划放哪。实现起来就是在右侧固定位置根据next_block的形状画一个小号的方块预览。别小看这个小功能实际体验的提升非常明显。字体渲染有个小坑pygame 默认字体不支持中文如果你想把“分数”“游戏结束”这些文字显示成中文需要加载系统字体。否则屏幕上会出现一排小方框乱码。最简单的做法是用pygame.font.SysFont(simsun, 36)或者microsoftyahei。如果你在 Linux 或 macOS 上跑字体名要换成你系统里有的中文字体比如notosanscjk。4. 常见问题与排查技巧实录写这个项目的时候有几个问题几乎每个初学者都会碰到我把它们和对应的解决思路整理成一张速查表方便你对着排查。问题原因解决方法方块叠到网格里还能继续移动固定方块后没有把值写进网格检查固定逻辑是否调用了merge_to_grid()旋转时方块突然跳到老远的地方旋转后的矩阵没有做边界偏移处理加上壁踢逻辑尝试 0、±1、±2 的偏移量消行后整个网格都在闪烁消行时直接删除中间行导致索引错乱用“过滤 头部补空行”的方式重写按方向键没反应或反应迟钝事件类型用错KEYDOWN和KEYUP混淆确认用的是KEYDOWN且逻辑写在事件循环里游戏速度越来越快自动下落计时没有随分数调整根据分数调整下落间隔fall_speed max(0.1, 1 - score / 5000)程序一打开就闪退缺少字体或图片资源检查字体初始化代码确认路径存在4.1 下落速度怎么控制才自然自动下落最原始的实现是每帧都让方块下移一格但这样游戏速度快到没法玩。实际标准做法是用计时器每次下落之间间隔一定时间间隔到了才让方块下移。这个时间初始设 1 秒随分数增加逐步缩短最短不要低于 0.1 秒否则几乎没法操作。我是用pygame.time.get_ticks()获取当前毫秒数和上次下落时间做差大于间隔时间就触发一次下落。这个方法比在事件循环里用pygame.time.set_timer()更灵活因为你可以随时调整下落间隔而且不会因为事件队列堆积导致多个下落事件同时触发。实测后期速度快了set_timer模式下偶尔会出现方块一次性掉两格的抖动问题get_ticks方案则没有这个问题。4.2 按键手感与输入延迟俄罗斯方块的操作响应速度直接影响游戏体验。如果你把移动逻辑写在KEYDOWN事件里按一次只会移动一格按住不动不会连续移动。想要“按住连续移动”需要额外处理。一个简单可用的方案是在游戏循环里检测pygame.key.get_pressed()它返回一个布尔数组表示当前所有按键的状态。你可以在每帧更新时判断“左键被按住”就执行移动。但直接这么做会移动得过快所以需要加一个延迟计时器按键被按住超过 100ms 后每 50ms 移动一次。前 100ms 是“起始延迟”防止玩家轻轻碰一下方向键方块就飞出去。这两个参数100ms 起始延迟、50ms 重复间隔参考了经典红白机手柄的操作手感。我实际试玩对比过不加延迟的版本操作非常飘加了之后手感扎实很多。4.3 性能与画面闪烁俄罗斯方块对性能要求不高但如果你的绘制代码存在穿回还是会出现微妙的闪烁。核心原则所有绘制只放在渲染阶段游戏逻辑和输入处理都不要去动屏幕内容。统一用screen.fill(BG_COLOR)清屏再从头绘制所有元素。另外一个减少闪烁和卡顿的技巧是把不变的元素网格线、预览框提前绘制到一张静态的Surface上主循环里直接blit()这张图再画动态的方块。实测下来帧率从 60 FPS 提升到 120 FPS 以上但对这个项目来说其实感觉不出差别。不过这是用 pygame 做任何 2D 游戏都实用的优化技巧值得养成习惯。4.4 游戏结束判定游戏结束的条件是新方块生成时立刻与已有方块发生碰撞。因为新方块出生在网格顶部如果顶部已经堆满了方块说明玩家已经玩不下去了。判定逻辑写在spawn_block()里生成新方块后立即检查碰撞如果碰撞就把game_over置为True。这里有一个体验细节我踩过坑不要把“游戏结束”直接写在由玩家操作触发的固定函数里而是统一在生成新方块时判断。否则会出现一种情况某次方块固定后消行消掉了几行但生成新方块时还是判定游戏结束就会误判。正确做法是先生成新方块、再检测碰撞不要先检测碰撞再生成。5. 运行效果与后续扩展建议跑通基本功能之后你会在右下角看到一个 10×20 的网格区域方块下落、左右移、旋转、消行都正常。游戏界面加上右侧的“下一个方块”预览和得分显示整体观感已经接近一个正经的成品游戏了。如果想让这个项目从“作业”变成“作品”我推荐这几个扩展方向按难度从低到高排列幽灵方块在当前下落方块的同一列底部用半透明方式绘制一个落点预览帮助玩家精确摆放。实现方式很简单复制当前位置不断向下移动直到碰撞然后画一个轮廓。音效与背景音乐pygame 自带的mixer模块就能播放 WAV 格式音效消行、旋转、硬降各配一个音效游戏沉浸感立刻上一个档次。素材可以从免费音效网站下载并注明来源。等级加速每消除十行升一级每级下落速度提升一档这也是经典俄罗斯方块的难度曲线。最高分存档把最高分写到本地 JSON 或 SQLite 文件里每次游戏结束读取并更新。这个功能可以顺便练习下文件操作和简单的数据持久化。暂停功能按 P 键暂停游戏再按继续。实现就是给主循环加一个状态变量暂停时跳过更新逻辑但继续渲染画面。我个人实际做下来从零开始写完整个项目大概花了三个晚上每天两小时左右。第一天搭骨架和方块渲染第二天写移动和旋转逻辑、消行判定第三天处理手感优化和界面完善。期间遇到的最大坑就是旋转后的碰撞检测边界问题调试了差不多一晚上最后还是通过加打印日志、把每一步的网格状态打印出来才定位到问题。所以强烈建议你在调试时多使用打印输出把grid和block的状态打出来看比对着黑屏幕猜要高效得多。这个项目你的收获不会只停留在“我会写俄罗斯方块了”这件事上。从数据结构二维数组与矩阵变换、算法碰撞检测到事件驱动编程主循环与输入处理它把 Python 基础到进阶的很多知识点全部串起来了。以后不管你是想往游戏开发方向走还是转去做数据处理、自动化脚本这套“拆问题—设计模型—实现—调试”的方法论都通用。拿去玩吧祝你写出来的俄罗斯方块能陪你度过不少摸鱼的快乐时光。本文还有配套的精品资源点击获取
简介这是一份基于Python语言实现的俄罗斯方块小游戏源码包主要面向Python初学者、游戏开发爱好者以及需要课程设计的同学。压缩包内共包含4个文件以1个核心Python脚本为主另附2个wav格式游戏音效和1个mp3背景音乐整体大小仅6MB轻量易用。代码采用模块化方式组织覆盖棋盘布局、方块生成与旋转、自动下落、碰撞检测、消行得分等经典俄罗斯方块核心机制并集成音效反馈与背景音乐与网上零散代码不同这份压缩包将程序与音效素材打包完整下载即可运行体验。目前该资源已有322人学习下载说明其在学习参考方面具备一定热度。读者不仅可以直接运行游玩还可以在此基础上二次开发增加等级加速、最高分记录、暂停与开始界面等个性化功能是理解游戏循环和Python编程逻辑的实用案例。 俄罗斯方块这玩意儿大概是游戏开发里最经典的入门项目了。逻辑不复杂但麻雀虽小五脏俱全从数据建模、碰撞检测到界面渲染一个完整的小游戏该有的环节它全都有。用 Python 写一个能跑起来的版本比想象中要费点心思但收获也是实打实的——尤其适合刚学完语法、想找个项目练手的朋友。这篇文我会从零开始把整个实现思路、核心代码、还有我实际踩过的坑都捋一遍。不是那种丢一份完整代码让你跑完就完事的教程而是把“为什么这么写”讲清楚这样你拿到任何一块逻辑都能自己改、自己扩展。1. 整体方案与核心设计思路先说我最终选定的技术方案Python 3.10 pygame 2.x。为什么用 pygame因为它就是 Python 生态里做 2D 小游戏最省事的库窗口创建、事件处理、图形绘制、帧率控制全都帮你封装好了你不用去碰底层的窗口 API 或者图形渲染逻辑能专注在游戏逻辑本身。游戏的核心数据模型其实特别朴素就三样东西一个二维数组表示的网格棋盘、一个当前方块、一个下一个方块。网格负责记录已经固定的方块位置当前方块负责移动和旋转下一个方块只是用来预览顺便让玩家有点盼头。我建议把代码拆成三个模块而不是全部塞进一个文件里tetris.py定义方块形状、颜色、旋转逻辑game.py定义游戏类负责网格、碰撞、消行、计分main.py主循环处理输入、驱动游戏逻辑、渲染画面初始版本可以把三者合并到一个文件里跑通但拆开更有利于你后续加功能——比如加音效、加等级加速、加“幽灵方块”预览落点。我实测下来拆开写之后的调试体验会舒服很多因为每个模块的职责边界清晰出问题能快速定位。1.1 网格与坐标系的设定俄罗斯方块的标准网格是 10 列 × 20 行列数多了游戏太宽松少了又挤得慌10×20 是多年验证下来的黄金比例。我用一个二维列表来表达网格每个元素要么是0空要么是颜色值该位置已被方块占用。这里有个非常容易踩的坑网格的行列索引和屏幕坐标的方向关系。我习惯把grid[row][col]定义成第row行、第col列也就是先纵后横。但在 pygame 的坐标系里画矩形用的是(x, y)先横后纵。如果不做转换画出来的方块会“翻转”或者错位。所以我在写draw函数时会明确做一次换算x col * BLOCK_SIZEy row * BLOCK_SIZE每次画之前都想清楚自己在操作哪个坐标系否则很容易画出歪七扭八的东西。1.2 方块形状的数据建模七种经典方块I、O、T、S、Z、J、L的数据模型也值得琢磨。最直观的表示方式是用 4×4 或者 3×3 的布尔矩阵包含方块形状的地方为1其余为0。比如 T 型方块可以表示为[0, 1, 0], [1, 1, 1], [0, 0, 0]每个方块我还会配一个颜色元组(r, g, b)比如 T 型方块用紫色(128, 0, 128)I 型用青色(0, 255, 255)。这个颜色不只是好看调试时也能靠颜色快速判断当前操作的是哪个方块。所有方块统一存在一个字典或者列表里每种方块附带它的 spawn 位置生成位置。我实测下来I 型方块因为长度是 4它的生成位置需要单独处理否则一出生就顶到左边界或者右边界这种情况是新手最容易忽略的。2. 七种方块的表示与旋转算法这节是俄罗斯方块实现里最值得花时间琢磨的部分。旋转看似简单但牵涉到坐标系变换和边界条件写不好就会出现“方块旋转后位置偏移”或者“旋转后穿墙”的诡异现象。2.1 旋转矩阵与坐标变换先聊数学基础。二维平面上把一个点绕原点顺时针旋转 90 度变换公式是新x 原y 新y -原x但方块矩阵的旋转不能直接套这个公式因为矩阵的“原点”在左上角行号向下增长跟数学坐标系的 y 轴方向是反的。我实际用的是“转置 行反转”的组合拳来实现顺时针旋转先对矩阵做转置行列互换再把每一行反转这个操作的直观理解是把矩阵竖过来再左右翻一下形状就会顺时针转动 90 度。代码实现很简洁def rotate_clockwise(matrix): return [list(row) for row in zip(*matrix)][::-1]zip(*matrix)做转置[::-1]做行反转。实测对七种方块都适用无需单独处理。2.2 旋转后位置校正旋转时最容易出的 bug 是方块靠墙时一旋转旋转后的形状有一部分超出了网格边界或者叠到了已经固定的方块上面。最简单的处理方式是“尝试旋转失败就不转”但这会让玩家在靠墙时完全无法旋转操作手感很差。业界标准的做法是“墙踢”Wall Kick。核心思路是旋转后如果发生碰撞就把方块分别向左右平移 1 格、2 格再尝试直到找到一个合法位置。如果所有偏移都失败才放弃这次旋转。这个机制只加了几行代码但手感会天差地别def try_rotate(grid, block): rotated rotate_clockwise(block.shape) for dx in (0, -1, 1, -2, 2): if not collides(grid, block.x dx, block.y, rotated): block.shape rotated block.x dx break我加了从 0 到正负 1、2 的偏移序列基本覆盖了靠墙旋转的常见场景。注意偏移顺序有讲究先试原位再试左右各 1 格最后才试 2 格。因为大多数情况下原位就能放下这样可以减少不必要的计算。2.3 碰撞检测的判定条件碰撞检测的规则其实很简单方块矩阵里的每个1对应的网格位置要么出了网格边界左、右、下要么网格里已经有固定方块。任何一条满足就算碰撞。这里有个性能细节没必要检查方块 4×4 矩阵里的所有 16 个位置只需要检查矩阵里值为1的位置。你可以预先做一个坐标列表比如方块在矩阵里的那些非零格子的相对偏移移动时只遍历这个列表把(x col, y row)换算成网格坐标去查效率更高而且逻辑更清晰。网格 200 格方块最多 4 格这种规模下性能差异不大但代码可读性会好很多。我实际写代码时用了一个更简单的方案先判断边界条件x 是否小于 0、x 是否超过 10、y 是否超过 20再判断是否和已固定的方块重叠。因为网格本身很小这种顺序判断在最坏情况下也只有 4 次网格查询完全够用。3. 完整实现步骤与关键代码解析先说环境准备。确保你本机装好了 Python 3.10 或更高版本然后用 pip 把 pygame 装进来pip install pygame如果你用的编辑器是 VS Code建议在项目根目录建一个.venv虚拟环境再装依赖不然全局环境装多了容易跟其他项目冲突。这个习惯我建议从一开始就养成别等出了依赖冲突再后悔。3.1 游戏类的骨架设计我用一个Game类来封装所有游戏状态。初始化时做这几件事创建 20×10 的全零网格、随机选一个当前方块和下一个方块、初始化分数和游戏结束标记。核心属性就五个grid、current_block、next_block、score、game_over。class Game: def __init__(self): self.grid [[0] * COLS for _ in range(ROWS)] self.current_block random_block() self.next_block random_block() self.score 0 self.game_over False注意一个 Python 的老坑[[0] * COLS] * ROWS这样写是不对的因为乘法创建的是同一个列表的引用改一行会带动所有行变化。必须用列表推导式[[0] * COLS for _ in range(ROWS)]创建一个全新的二维列表。这个坑我当年踩得莫名其妙排查了半天才发现是引用共享的问题这里先帮你排掉。3.2 游戏主循环的三段式结构pygame 的主循环其实是非常固定的三段式处理事件、更新状态、渲染画面。对应到俄罗斯方块就是读取键盘输入、尝试移动或旋转方块、让方块自动下落、检查消行、再画出所有东西。while not game.game_over: for event in pygame.event.get(): if event.type pygame.QUIT: run False if event.type pygame.KEYDOWN: if event.key pygame.K_LEFT: game.move(-1, 0) elif event.key pygame.K_RIGHT: game.move(1, 0) elif event.key pygame.K_DOWN: game.move(0, 1) elif event.key pygame.K_UP: game.try_rotate() elif event.key pygame.K_SPACE: game.hard_drop() game.update() game.draw(screen) pygame.display.flip() clock.tick(60)pygame.display.flip()负责把画好的内容真正显示到屏幕上而clock.tick(60)保证帧率稳定在 60 FPS别小看这两行少了它们游戏画面会撕裂或者跑得飞快。3.3 方块的固定与消行逻辑方块落到不能继续下落时要做两件事把方块写进网格然后检查有没有满行需要消除。写进网格就是把方块矩阵里的1对应的坐标填上颜色值。消行逻辑很有意思。很多人的第一反应是“从上往下判断哪些行满了然后一行一行删掉”。但 Python 的列表提供了更优雅的做法遍历所有行把不满的行保留下来然后在列表头部补充相应数量的空行。这样一次遍历就能搞定消行而且不会出现删除中间行导致索引错乱的问题def clear_lines(self): new_grid [row for row in self.grid if any(cell 0 for cell in row)] lines_cleared ROWS - len(new_grid) for _ in range(lines_cleared): new_grid.insert(0, [0] * COLS) self.grid new_grid self.score lines_cleared * 100这里any(cell 0 for cell in row)是判断“这行是不是还有空位”如果有空位就保留满行就被自然过滤掉。insert(0, ...)在头部插入新行模拟上方的新方块掉下来。计分规则我用了最简单的方式消除 n 行得 n × 100 分实际游戏可以再细化成 100、300、500、800 的阶梯计分看你喜好。顺带一提硬降hard drop的实现当玩家按下空格键时让方块一路下落到底。用 while 循环反复执行“尝试下移失败就固定”然后立即固定方块并切换到下一个方块。手感上要保留一次 soft drop 的加分一般加 1 分让追求极限分数的玩家有得玩。3.4 渲染与画面绘制绘制的逻辑分三层背景网格线、已固定的方块、当前下落的方块。背景网格用灰色细线画出 10×20 的格子让玩家对位置有参考。已固定方块遍历网格值不为 0 的位置画对应颜色的实心矩形。当前下落方块则根据它的坐标和形状矩阵画在网格上方通常再加一个边框让它的轮廓更清晰。这里有个体验优化我建议把“下一个方块”的预览画在游戏区域右侧这样玩家可以提前规划放哪。实现起来就是在右侧固定位置根据next_block的形状画一个小号的方块预览。别小看这个小功能实际体验的提升非常明显。字体渲染有个小坑pygame 默认字体不支持中文如果你想把“分数”“游戏结束”这些文字显示成中文需要加载系统字体。否则屏幕上会出现一排小方框乱码。最简单的做法是用pygame.font.SysFont(simsun, 36)或者microsoftyahei。如果你在 Linux 或 macOS 上跑字体名要换成你系统里有的中文字体比如notosanscjk。4. 常见问题与排查技巧实录写这个项目的时候有几个问题几乎每个初学者都会碰到我把它们和对应的解决思路整理成一张速查表方便你对着排查。问题原因解决方法方块叠到网格里还能继续移动固定方块后没有把值写进网格检查固定逻辑是否调用了merge_to_grid()旋转时方块突然跳到老远的地方旋转后的矩阵没有做边界偏移处理加上壁踢逻辑尝试 0、±1、±2 的偏移量消行后整个网格都在闪烁消行时直接删除中间行导致索引错乱用“过滤 头部补空行”的方式重写按方向键没反应或反应迟钝事件类型用错KEYDOWN和KEYUP混淆确认用的是KEYDOWN且逻辑写在事件循环里游戏速度越来越快自动下落计时没有随分数调整根据分数调整下落间隔fall_speed max(0.1, 1 - score / 5000)程序一打开就闪退缺少字体或图片资源检查字体初始化代码确认路径存在4.1 下落速度怎么控制才自然自动下落最原始的实现是每帧都让方块下移一格但这样游戏速度快到没法玩。实际标准做法是用计时器每次下落之间间隔一定时间间隔到了才让方块下移。这个时间初始设 1 秒随分数增加逐步缩短最短不要低于 0.1 秒否则几乎没法操作。我是用pygame.time.get_ticks()获取当前毫秒数和上次下落时间做差大于间隔时间就触发一次下落。这个方法比在事件循环里用pygame.time.set_timer()更灵活因为你可以随时调整下落间隔而且不会因为事件队列堆积导致多个下落事件同时触发。实测后期速度快了set_timer模式下偶尔会出现方块一次性掉两格的抖动问题get_ticks方案则没有这个问题。4.2 按键手感与输入延迟俄罗斯方块的操作响应速度直接影响游戏体验。如果你把移动逻辑写在KEYDOWN事件里按一次只会移动一格按住不动不会连续移动。想要“按住连续移动”需要额外处理。一个简单可用的方案是在游戏循环里检测pygame.key.get_pressed()它返回一个布尔数组表示当前所有按键的状态。你可以在每帧更新时判断“左键被按住”就执行移动。但直接这么做会移动得过快所以需要加一个延迟计时器按键被按住超过 100ms 后每 50ms 移动一次。前 100ms 是“起始延迟”防止玩家轻轻碰一下方向键方块就飞出去。这两个参数100ms 起始延迟、50ms 重复间隔参考了经典红白机手柄的操作手感。我实际试玩对比过不加延迟的版本操作非常飘加了之后手感扎实很多。4.3 性能与画面闪烁俄罗斯方块对性能要求不高但如果你的绘制代码存在穿回还是会出现微妙的闪烁。核心原则所有绘制只放在渲染阶段游戏逻辑和输入处理都不要去动屏幕内容。统一用screen.fill(BG_COLOR)清屏再从头绘制所有元素。另外一个减少闪烁和卡顿的技巧是把不变的元素网格线、预览框提前绘制到一张静态的Surface上主循环里直接blit()这张图再画动态的方块。实测下来帧率从 60 FPS 提升到 120 FPS 以上但对这个项目来说其实感觉不出差别。不过这是用 pygame 做任何 2D 游戏都实用的优化技巧值得养成习惯。4.4 游戏结束判定游戏结束的条件是新方块生成时立刻与已有方块发生碰撞。因为新方块出生在网格顶部如果顶部已经堆满了方块说明玩家已经玩不下去了。判定逻辑写在spawn_block()里生成新方块后立即检查碰撞如果碰撞就把game_over置为True。这里有一个体验细节我踩过坑不要把“游戏结束”直接写在由玩家操作触发的固定函数里而是统一在生成新方块时判断。否则会出现一种情况某次方块固定后消行消掉了几行但生成新方块时还是判定游戏结束就会误判。正确做法是先生成新方块、再检测碰撞不要先检测碰撞再生成。5. 运行效果与后续扩展建议跑通基本功能之后你会在右下角看到一个 10×20 的网格区域方块下落、左右移、旋转、消行都正常。游戏界面加上右侧的“下一个方块”预览和得分显示整体观感已经接近一个正经的成品游戏了。如果想让这个项目从“作业”变成“作品”我推荐这几个扩展方向按难度从低到高排列幽灵方块在当前下落方块的同一列底部用半透明方式绘制一个落点预览帮助玩家精确摆放。实现方式很简单复制当前位置不断向下移动直到碰撞然后画一个轮廓。音效与背景音乐pygame 自带的mixer模块就能播放 WAV 格式音效消行、旋转、硬降各配一个音效游戏沉浸感立刻上一个档次。素材可以从免费音效网站下载并注明来源。等级加速每消除十行升一级每级下落速度提升一档这也是经典俄罗斯方块的难度曲线。最高分存档把最高分写到本地 JSON 或 SQLite 文件里每次游戏结束读取并更新。这个功能可以顺便练习下文件操作和简单的数据持久化。暂停功能按 P 键暂停游戏再按继续。实现就是给主循环加一个状态变量暂停时跳过更新逻辑但继续渲染画面。我个人实际做下来从零开始写完整个项目大概花了三个晚上每天两小时左右。第一天搭骨架和方块渲染第二天写移动和旋转逻辑、消行判定第三天处理手感优化和界面完善。期间遇到的最大坑就是旋转后的碰撞检测边界问题调试了差不多一晚上最后还是通过加打印日志、把每一步的网格状态打印出来才定位到问题。所以强烈建议你在调试时多使用打印输出把grid和block的状态打出来看比对着黑屏幕猜要高效得多。这个项目你的收获不会只停留在“我会写俄罗斯方块了”这件事上。从数据结构二维数组与矩阵变换、算法碰撞检测到事件驱动编程主循环与输入处理它把 Python 基础到进阶的很多知识点全部串起来了。以后不管你是想往游戏开发方向走还是转去做数据处理、自动化脚本这套“拆问题—设计模型—实现—调试”的方法论都通用。拿去玩吧祝你写出来的俄罗斯方块能陪你度过不少摸鱼的快乐时光。本文还有配套的精品资源点击获取
