简介这是一份面向计算机相关专业学生与初学者的Python pygame游戏开发实训资源以经典俄罗斯方块为案例适合用作课程设计、毕业设计、作业提交或自学练手。压缩包共6个文件约6.88MB包含py主程序源码、wav与mp3音效素材、txt分数记录文件、md说明文档以及docx设计报告覆盖代码、素材与文档三类内容结构清晰便于直接运行与二次修改。资源完整呈现了游戏主循环、方块生成与旋转、碰撞检测、消行计分、音效播放等核心逻辑设计报告可供参考学习帮助读者理解项目架构与实现思路。目前已有46人学习下载适合基础尚可的同学在此基础上扩展功能也方便新手对照文档逐步复现遇到配置或运行问题还可获得远程指导与技术支持。1. 一份能直接跑通的 pygame 俄罗斯方块课设到底值不值得下课程设计周刚开始选题表上「俄罗斯方块」五个字看着简单真动手才发现坑不少方块旋转后的碰撞检测怎么写、消行后怎么补位、下落速度怎么随等级变化、音效和背景音乐怎么和游戏主循环共存。这份基于 Python pygame 的经典俄罗斯方块小游戏开发资源就是冲着这些具体问题来的。它包含完整的 tetris.py 主程序、assets 素材目录、music 与 sound 音频资源、scores.txt 分数存档还有一份设计报告文档。适合计算机相关专业做课程设计、毕业设计初期的同学也适合刚学完 Python 基础想找一个完整项目练手的人。代码经过测试能稳定运行结构清晰改起来不费劲。2. 环境搭建与主循环骨架从 pip install pygame 到窗口跑起来2.1 为什么选 pygame 而不是别的方案做俄罗斯方块这类 2D 网格游戏选型其实就两条路要么用 pygame 这类底层库自己管渲染和事件要么用 Godot、Unity 这类引擎。Godot 做游戏开发确实快但课程设计场景下老师要看的是你对 Python 语言本身和基础算法的掌握用引擎反而把核心逻辑藏起来了。pygame 的好处是足够「裸」——窗口、事件循环、Surface 绘制、时钟控制全在你手里方块的数据结构、旋转矩阵、碰撞判断这些都得自己写正好是课设要考察的点。另一个现实原因是环境。pygame 装起来就一行命令不依赖庞大的编辑器VS Code 配好 Python 环境就能写。相比之下Godot 要单独装编辑器、学 GDScript对只想交个课设的人来说学习成本偏高。所以这份资源选 pygame 是合理的不是图省事是匹配场景。2.2 环境配置的完整步骤先把 Python 环境弄好。建议用 3.8 到 3.11 之间的版本太新的版本偶尔会遇到 pygame 轮子还没跟上。装完 Python 后配置环境变量确保命令行里能直接敲 python。# 检查 Python 版本确认在 3.8 以上 python --version # 安装 pygame这是唯一的第三方依赖 pip install pygame # 如果下载慢换国内镜像源 pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple装完后验证一下能打印出版本号就说明成了import pygame print(pygame.version.ver) # 输出类似 2.5.2如果 import pygame 报 ModuleNotFoundError八成是 pip 装到了另一个 Python 解释器下。常见情况是系统里有多个 PythonVS Code 选的解释器和命令行 pip 对应的不是同一个。解决办法是在 VS Code 里按 CtrlShiftP选 Python: Select Interpreter挑那个装了 pygame 的解释器。这个坑我见过太多次新手卡在这里能卡一下午。2.3 主循环骨架与关键参数pygame 游戏的核心就是一个 while 循环每帧做三件事处理事件、更新状态、绘制画面。这份资源的 tetris.py 也是这个结构。下面是我从项目里提炼的主循环骨架参数含义都标在注释里import pygame import sys # 网格参数10 列 20 行是俄罗斯方块的标准比例 COLS, ROWS 10, 20 CELL 30 # 每个格子的像素边长30 是 900x600 窗口下的常用值 pygame.init() screen pygame.display.set_mode((COLS * CELL, ROWS * CELL)) pygame.display.set_caption(Tetris) clock pygame.time.Clock() # 下落计时器用累加时间控制下落而不是靠帧数 fall_time 0 fall_speed 500 # 毫秒数值越小方块掉得越快 while True: dt clock.tick(60) # 限制 60 帧dt 是距上一帧的毫秒数 fall_time dt for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() # 键盘事件在这里处理左右移动和旋转 if fall_time fall_speed: fall_time 0 # 这里触发方块下落一格并做碰撞检测 screen.fill((0, 0, 0)) # 绘制网格、当前方块、已固定方块 pygame.display.flip()逻辑说明clock.tick(60) 既限制帧率又返回时间差用 dt 累加来控制下落比用帧计数更稳因为不同机器帧率会波动。fall_speed 是难度调节的核心参数500 毫秒对应中等难度想加难度就按等级递减比如每消 10 行减 50 毫秒但别低于 100否则人眼反应不过来。碰撞检测的思路是先假设方块移动后的新坐标检查每个格子是否越界或与已固定方块重叠重叠就回退。这个「先试后撤」的模式贯穿整个游戏逻辑旋转也一样处理。3. 方块数据结构与旋转碰撞把七种形状管明白3.1 用坐标列表还是矩阵表示方块俄罗斯方块有七种基本形状行话叫 Tetromino。表示方法常见两种一是用二维矩阵存形状旋转就是矩阵转置加翻转二是用一组相对坐标点存旋转就是坐标变换。这份资源用的是坐标列表法好处是直观、好调试。# 每种形状用一组 (x, y) 相对坐标表示原点在形状的左上角 SHAPES { I: [(0, 1), (1, 1), (2, 1), (3, 1)], O: [(1, 0), (2, 0), (1, 1), (2, 1)], T: [(1, 0), (0, 1), (1, 1), (2, 1)], S: [(1, 0), (2, 0), (0, 1), (1, 1)], Z: [(0, 0), (1, 0), (1, 1), (2, 1)], J: [(0, 0), (0, 1), (1, 1), (2, 1)], L: [(2, 0), (0, 1), (1, 1), (2, 1)], } # 每种形状配一个颜色绘制时按类型取色 COLORS { I: (0, 240, 240), O: (240, 240, 0), T: (160, 0, 240), S: (0, 240, 0), Z: (240, 0, 0), J: (0, 0, 240), L: (240, 160, 0), }参数说明坐标用整数格不涉及像素绘制时再乘以 CELL 换算。O 形用四个点而不是一个 2x2 块是为了和其他形状统一处理逻辑旋转时 O 形坐标不变即可。颜色值是 RGB 元组取自经典俄罗斯方块的配色改起来直接换数值就行。3.2 旋转的实现与墙踢旋转最容易翻车的地方是「贴墙旋转」。方块在左右边界时旋转新坐标可能超出网格直接判定非法就会导致玩家感觉「转不动」。标准做法是旋转失败后尝试左右平移一格再转这叫墙踢wall kick。def rotate(shape_coords): # 绕形状中心做 90 度旋转(x, y) - (-y, x) # 先找中心避免旋转后整体偏移 cx sum(x for x, y in shape_coords) / len(shape_coords) cy sum(y for x, y in shape_coords) / len(shape_coords) rotated [] for x, y in shape_coords: # 相对中心旋转后再取整 nx round(cx - (y - cy)) ny round(cy (x - cx)) rotated.append((nx, ny)) return rotated def try_rotate(board, piece): new_coords rotate(piece.coords) # 依次尝试原地转、左移一格转、右移一格转 for dx in (0, -1, 1): if is_valid(board, new_coords, piece.x dx, piece.y): piece.coords new_coords piece.x dx return True return False # 三种都失败放弃这次旋转逻辑说明rotate 函数先算形状的几何中心每个点相对中心旋转 90 度。round 是为了把浮点结果拉回整数格。try_rotate 里的 dx 循环就是墙踢先试原地不行就左移或右移一格。is_valid 检查新坐标是否都在网格内且不与已固定方块重叠。注意 I 形和 O 形旋转后中心可能偏移实际项目里常给每种形状单独写旋转偏移表这份资源用的是通用算法够用但极端情况下 I 形贴墙旋转偶尔会失败属于可接受的简化。3.3 碰撞检测与锁定碰撞检测是游戏逻辑的地基写错了会出现方块穿墙、重叠、消行错位各种玄学问题。核心就一个函数def is_valid(board, coords, offset_x, offset_y): for x, y in coords: gx, gy x offset_x, y offset_y # 越界检查左右下三边 if gx 0 or gx COLS or gy ROWS: return False # 重叠检查board 里非空的位置不能占 if gy 0 and board[gy][gx]: return False return True参数说明board 是 ROWS 行 COLS 列的二维列表0 表示空非 0 存颜色或形状标记。gy 0 的情况允许因为方块刚生成时可能有一部分在屏幕上方。下落时每帧尝试 offset_y 1不合法就说明触底把方块坐标写进 board 并生成新方块。这里有个细节写进 board 后要立刻检查消行消行要从下往上遍历消掉一行后上面的行整体下移别用正序遍历否则会漏消。4. 消行计分、音效与存档让游戏像个完整作品4.1 消行逻辑与计分规则消行本身不难难在消完之后的行索引处理。常见做法是重建 board把非满行保留满行丢弃然后在顶部补空行。def clear_lines(board): # 保留所有非满行 new_board [row for row in board if not all(row)] cleared ROWS - len(new_board) # 顶部补空行 for _ in range(cleared): new_board.insert(0, [0] * COLS) return new_board, cleared # 计分一次消得越多分越高鼓励玩家攒行 SCORE_TABLE {1: 100, 2: 300, 3: 500, 4: 800}逻辑说明all(row) 判断一行是否全非零全非零就是满行。列表推导保留非满行再在头部插入空行行数守恒。计分用查表法一次消四行Tetris给 800 分是经典规则。等级可以按总消行数除以 10 来算每升一级 fall_speed 减 50 毫秒。4.2 音效与背景音乐的加载pygame 的音频模块分两块pygame.mixer.music 管背景音乐流式播放适合长音频pygame.mixer.Sound 管短音效一次性加载进内存。资源里的 music 和 sound 目录就是按这个分的。pygame.mixer.init() # 背景音乐循环播放音量调低不盖过音效 pygame.mixer.music.load(music/bgm.mp3) pygame.mixer.music.set_volume(0.3) pygame.mixer.music.play(-1) # -1 表示无限循环 # 音效消行、旋转、落地各一个 sound_clear pygame.mixer.Sound(sound/clear.wav) sound_rotate pygame.mixer.Sound(sound/rotate.wav) sound_clear.set_volume(0.6) # 触发时直接 play sound_clear.play()参数说明set_volume 取值 0.0 到 1.0背景音乐建议 0.2 到 0.4音效 0.5 到 0.8否则混在一起很吵。play(-1) 的 -1 是无限循环想循环固定次数就传正整数。注意 mixer.init() 要在 pygame.init() 之后调用且音频文件路径要对路径错了不会报错只是没声音这是排查无声问题的第一检查点。4.3 分数存档与读取scores.txt 用来存历史最高分逻辑简单但要注意文件不存在时的处理否则第一次运行就崩。import os SCORE_FILE scores.txt def load_high_score(): if not os.path.exists(SCORE_FILE): return 0 # 文件不存在返回 0别让它抛异常 with open(SCORE_FILE, r) as f: content f.read().strip() return int(content) if content else 0 def save_high_score(score): with open(SCORE_FILE, w) as f: f.write(str(score))逻辑说明读取时先判断文件存在再判断内容非空两层保护。写入用 w 模式直接覆盖因为只存一个最高分。如果要做排行榜就改成读多行、排序、取前几名。游戏结束时比较当前分和最高分超过就调用 save_high_score。5. 避坑与排查那些让课设卡壳的常见问题5.1 窗口一闪而过或直接卡死现象运行 tetris.py 后窗口闪一下就没了或者点关闭按钮没反应。原因通常是事件循环里没处理 QUIT 事件或者 pygame.quit() 和 sys.exit() 没配对。解决确保事件循环里有if event.type pygame.QUIT分支里面先 pygame.quit() 再 sys.exit()。如果窗口卡死检查是不是在循环里写了阻塞操作比如 input() 或者 time.sleep() 太长。5.2 方块旋转后位置跳变现象按旋转键方块突然跑到别的位置。原因是用坐标列表法时旋转中心算错或者旋转后没做取整导致坐标漂移。解决旋转前先算几何中心旋转后 round 取整并且旋转成功后要重新做一次 is_valid 校验。如果还是跳给每种形状单独写旋转后的坐标表别用通用算法。5.3 消行后上方方块不下移现象消掉一行上面的方块悬空不动。原因是消行时用了正序遍历删掉一行后索引错位。解决用重建 board 的方式列表推导保留非满行再补空行别在原地删。这个写法比原地操作安全得多也是我推荐的做法。5.4 音效不播放现象代码没报错但就是没声音。原因可能是音频文件路径不对、mixer 没初始化、或者音频格式不支持。解决先确认 pygame.mixer.init() 被调用再打印文件绝对路径确认文件存在最后检查格式wav 和 ogg 最稳mp3 在某些平台会有兼容问题。音量设成 0 也会无声检查 set_volume 的参数。5.5 打包或换机器后跑不起来现象在自己电脑上好好的拷给别人就报错。原因通常是依赖没装、路径用了绝对路径、或者 Python 版本不一致。解决把 pip install pygame 写进说明文档路径全部用相对路径别写C:\Users\xxx\...。如果要做成 exe用 pyinstaller但注意音频和图片资源要一起打包否则运行时找不到。6. 在现有代码上做二次开发三个能直接落地的改造方向拿到一份能跑的代码真正的价值在于改。这份资源的 tetris.py 结构清晰改起来有几个方向特别适合课设加分。第一个方向是加「下一个方块预览」。在窗口右侧留一块区域提前显示下一个形状。实现上就是在生成新方块时同时从形状池里再取一个存到 next_piece 变量绘制时在固定坐标画出来。形状池用随机选择但可以加个「7-bag」算法——把七种形状打乱后依次发保证不会连续出五个 S 形这种恶心情况。7-bag 的代码就几行import random bag [] def next_shape(): global bag if not bag: bag list(SHAPES.keys()) random.shuffle(bag) return bag.pop()逻辑说明bag 空了就重新装七种形状并打乱每次 pop 一个。这样每七次里每种形状恰好出现一次手感比纯随机好很多是现代俄罗斯方块的标准做法。第二个方向是加「暂存Hold」功能。按一个键把当前方块存起来下次需要时再换出来。实现要维护一个 held_piece 变量和一个「本回合是否已暂存」的标志防止无限换。这个功能代码量不大但能让你的课设明显区别于网上那些基础版。第三个方向是加「幽灵方块」——在当前方块正下方用半透明颜色画出落点预览。实现思路是从当前 y 坐标往下逐格试 is_valid找到最底部的合法位置然后用带 alpha 的 Surface 画出来。这个功能对玩家体验提升很大答辩时演示效果也好。改完之后一定要回归测试旋转、消行、计分、存档、音效逐项过一遍。我自己的习惯是每改一个功能就手动玩三局专门往边界上撞——贴左墙旋转、贴右墙旋转、堆到顶、一次消四行。这些边界场景最容易暴露问题。从那以后我每次交课设前都强制走一遍这个清单省得答辩现场翻车。希望这份资源和这些改造思路能帮到你。本文还有配套的精品资源点击获取