简介这是一份基于Python与Pygame开发的桌面端消消乐游戏完整项目专为计算机相关专业学生的课程设计、期末大作业以及需要项目实战练习的初学者准备。项目由大三学生独立完成经导师指导并获99分高分评价代码结构清晰、注释完整确保可直接运行适合用来理解游戏循环、碰撞检测、界面渲染及资源管理等核心概念。压缩包共120个文件大小9.57MB主要包含4个Python源码文件、70个PNG图片素材、20个MP3与20个OGG音频文件以及YAML配置、Markdown说明文档等。不同格式素材分工明确图片用于游戏界面与元素绘制音频承载背景音乐与消除特效音文档则提供环境配置与运行说明便于快速上手。目前已有140人学习下载资源内附完整项目源码、文档说明及必要资源文件涵盖场景搭建、消除逻辑、音效触发等模块可直接作为期末答辩或作品展示的实用参考也方便二次修改与功能扩展。整体内容紧凑适合作为Python游戏开发入门的练手项目。1. 从期末大作业到可运行的桌面端游戏pythonpygame 消消乐到底要写什么先说一个很多人在提交期末大作业时的误会老师要看的不是你截图里的“运行成功”而是一个能现场点着玩的程序。基于 pythonpygame 的桌面端消消乐恰恰是游戏类选题里最稳的一种——规则简单代码量可控制视觉反馈直接而且三消机制天然适合用“数据结构 算法”的框架来拆解。这篇文章按我习惯的工程路径展开先搭一个严谨的棋盘数据模型再做匹配与下落算法然后用 pygame 渲染成可交互窗口最后补上动画、打包和文档细节。目标读者是正在选期末题目的学生以及想用 pygame 快速搭 2D 原型验证玩法的开发者。读完你会得到一套能逐行解释、也能现场改参数的游戏骨架。2. 消消乐的核心不是 pygame是网格模型与匹配算法2.1 把棋盘存成二维数组你的三消逻辑就完成了一半消消乐的本质是在 R 行 × C 列的网格里每个单元格放一种图块tile。这个网格在内存里最自然的映射就是一个二维数组例如board[row][col] kind。kind 可以是整数0红色1绿色2蓝色……也可以是枚举或字符串。用整数最省事因为后面做颜色映射、随机生成、序列化保存全部可以直接查表不需要在循环里写一堆字符串比较。我习惯用一个类把棋盘包起来而不是让 grid 散落在全局变量里。期末项目里最常见的 bug 就是“某个函数偷偷改了你不知道的列表”封装能把这种问题挡在外面。最小可运行的版本长这样import random class Board: def __init__(self, rows9, cols9): self.rows rows self.cols cols self.grid [[0] * cols for _ in range(rows)] self.kind_count 6 # 6 种图块 self.score 0 def fill_random(self): for r in range(self.rows): for c in range(self.cols): self.grid[r][c] random.randrange(self.kind_count) def swap(self, r1, c1, r2, c2): self.grid[r1][c1], self.grid[r2][c2] self.grid[r2][c2], self.grid[r1][c1]grid用列表推导式创建避免[[0] * cols] * rows这种会共享同一行内存的错误写法kind_count是 6 而不是 3 或 8是因为 6 种颜色在 9×9 网格上能保证“视觉区分度”和“自然生成匹配的概率”之间的平衡。图块种类太少棋盘会频繁出现连锁游戏节奏过碎种类太多玩家半天凑不出三连体感像在玩破解版。2.2 三连检测算法横竖两种扫描一次标记再统一消除三消的核心判定是在一行或一列里找到连续相同类型长度 ≥ 3 的图块。算法本身很笨横向逐行扫纵向逐列扫遇到连续的相同 kind 就累计累计到 3 就把这些格子标记为“待消除”。关键设计是扫描只做标记不要直接改 board消除动作放在统一入口里执行。def scan_matches(self): 返回所有需要消除的坐标集合类型为 set[(r, c)] matches set() # 横向从左到右扫描每一行 for r in range(self.rows): c 0 while c self.cols: kind self.grid[r][c] end c while end self.cols and self.grid[r][end] kind: end 1 if end - c 3: for cc in range(c, end): matches.add((r, cc)) c end # 纵向从上到下扫描每一列 for c in range(self.cols): r 0 while r self.rows: kind self.grid[r][c] end r while end self.rows and self.grid[end][c] kind: end 1 if end - c 3: for rr in range(r, end): matches.add((rr, c)) r end return matches用 while 而不是 for是为了在定位一段连续区间后能直接跳到 end避免 for 逐个移动导致重复判断。matches用 set 而不是 list是因为同一格可能同时被横向和纵向扫描命中比如 L 形消除set 天然去重。横纵扫描合并后才能拿到一次消除的完整集合差一步都会出现“消除后棋盘还在闪”的错觉。2.3 消除、下落、补新每次重组都是一个完整的循环经典的三消循环是扫描得到 matches → 把匹配格子置空用 -1 表示空→ 每一列把非空元素压到底部 → 从顶部补充随机图块 → 重新扫描直到没有新匹配。这个循环写成代码就是整个游戏的“物理引擎”。def clear_matches(self, matches): for r, c in matches: self.grid[r][c] -1 def collapse_and_fill(self): 一次下落与补新调用前必须清空待消除的格子 for c in range(self.cols): col_vals [] for r in range(self.rows - 1, -1, -1): if self.grid[r][c] ! -1: col_vals.append(self.grid[r][c]) # 从下往上收集 for r in range(self.rows - 1, -1, -1): if col_vals: self.grid[r][c] col_vals.pop(0) else: self.grid[r][c] random.randrange(self.kind_count)col_vals 从底部开始收集再倒着回填这样既能保证同一列内原有次序不被打乱又不需要新建一整块辅助矩阵。pop(0) 在列表头部弹出是 O(n) 操作但对 9×9 棋盘来说每次只有最多 9 个元素性能完全无感如果要把棋盘扩展到 30×30 以上可以加一个指针或改用双端队列。整个循环的驱动放在主循环里而不是 Board 内部用 while 一层层套matches board.scan_matches() while matches: board.clear_matches(matches) board.collapse_and_fill() matches board.scan_matches()这个 while 循环每转一圈就意味着发生了一次“连锁”cascade。连锁次数是后面计分系统里最重要的参数所以最好在这里用一个变量接住它而不是等动画做完再重新扫描——动画只负责“好看”逻辑层在棋盘变完那一刻就已经知道这次操作能得多少分了。Board 各方法的职责和调用关系可以用下面的表直接对应起来步骤操作Board 中的方法调用注意扫描标记匹配格scan_matches只读可在任意时刻重复调用清除把匹配格置为 -1clear_matches只处理 scan_matches 的返回值下落补新重组一列数据collapse_and_fill与 clear_matches 成对出现连锁检测再次扫描scan_matches直到返回空集合3. 用 pygame 把数组变成桌面端画面渲染管线与事件循环3.1 pygame 初始化与主循环每个 2D 桌面端游戏的固定骨架先补一句环境问题如果卡在pip install pygame上最常见的报错是error: failed to build pygame when getting requirements to build wheel。这通常是 Python 版本太旧或系统缺少编译工具链处理方法是升级到 Python 3.9 以上再安装新版 pip 会直接拉预编译 wheel 而不是现场编译。遇到这个错先不要怀疑代码几乎都是环境问题。pygame 程序的起点高度相似初始化模块、创建窗口、准备时钟然后进入一个“事件 → 更新 → 绘制”的死循环。很多新手把代码堆在 while 外面结果窗口白屏或卡死原因就是没遵守这个骨架。最小模板长这样import pygame from board import Board FPS 60 CELL 60 # 每个格子边长像素 MARGIN 40 # 棋盘外留白 ROWS COLS 9 pygame.init() screen pygame.display.set_mode(( COLS * CELL MARGIN * 2, ROWS * CELL MARGIN * 2 )) pygame.display.set_caption(Match-3 Python Pygame) clock pygame.time.Clock() board Board(ROWS, COLS) board.fill_random() running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False if event.type pygame.MOUSEBUTTONDOWN: pass # 第 3.3 节填充 # 更新逻辑动画进度、连锁结算、状态切换 screen.fill((30, 30, 40)) # 绘制draw_board(screen, board) pygame.display.flip() clock.tick(FPS) pygame.quit()set_mode 的尺寸直接由棋盘规模推出来保证窗口中间内容始终完整不会因为硬编码 800×600 而多出半格clock.tick(FPS) 控制帧率上限同时返回上一帧耗时这个值在动画里会被反复用到。事件循环里不要放耗时操作比如磁盘读写或者大量计算否则鼠标会飘pygame 的事件队列会越积越多。3.2 坐标变换从 (row, col) 到像素的差一步就可能画歪棋盘逻辑坐标和屏幕像素坐标是两套系统逻辑层用 (row, col)渲染层用 (x, y)。两者之间需要一个显式的换算函数否则你会在绘制、点击判定、动画插值三个地方各写一遍魔法数字最后改格大小时漏改一处整个棋盘错位。def cell_to_pixel(r, c): 逻辑坐标 - 屏幕左上角像素坐标 return MARGIN c * CELL, MARGIN r * CELL def pixel_to_cell(pos): 屏幕坐标 - 逻辑坐标越界时返回 None x, y pos c (x - MARGIN) // CELL r (y - MARGIN) // CELL if 0 r ROWS and 0 c COLS: return r, c return None, None绘制棋盘时把 grid 里的每个 kind 映射成颜色块COLORS [ (255, 90, 90), # 0 红 (90, 200, 90), # 1 绿 (90, 140, 255), # 2 蓝 (250, 210, 80), # 3 黄 (200, 120, 255), # 4 紫 (255, 160, 80), # 5 橙 ] def draw_board(screen, board): for r in range(board.rows): for c in range(board.cols): kind board.grid[r][c] if kind 0: continue x, y cell_to_pixel(r, c) pygame.draw.rect( screen, COLORS[kind], pygame.Rect(x 2, y 2, CELL - 4, CELL - 4), border_radius8 )这里用圆角矩形代替贴图是为了省去美术素材的版权问题和尺寸处理。想换成图片时把 COLORS[kind] 换成预先加载的tile_images[kind]再用screen.blit(img, (x, y))输出即可。rect 的 x2 和 CELL-4 是为了让相邻方块之间留出 2 像素的缝隙三消游戏的棋盘如果没有缝隙视觉上会糊成一整片色块连击时很难看清边界。绘制相关的几个常量集中放在文件顶部方便答辩现场调参常量建议值作用CELL60每格边长像素MARGIN40棋盘与窗口边缘间距FPS60帧率上限动画计时基准COLORS 长度与 kind_count 一致颜色映射表必须覆盖所有图块种类3.3 鼠标交互选中、交换、无效操作回退的执行顺序pygame 的鼠标事件只告诉你“什么位置发生了什么”至于这个位置落在哪个格子里、该格与已选格是否相邻、交换后是否合法都是游戏逻辑层要回答的问题。我一般把处理顺序固定为未选择时点击 - 选中已选择时点击相邻格 - 尝试交换交换后没有匹配 - 换回去。selected None def handle_click(pos): global selected r, c pixel_to_cell(pos) if r is None or c is None: return if selected is None: selected (r, c) return r0, c0 selected selected None if abs(r0 - r) abs(c0 - c) ! 1: return # 不相邻重新选择 board.swap(r0, c0, r, c) if not board.scan_matches(): board.swap(r0, c0, r, c) # 无效交换回退 else: # 进入连锁清除循环并通知动画层开始播放 passabs(r0-r) abs(c0-c) 1 是曼哈顿距离的相邻判定它同时排除了对角线格子和斜向误触。交换后先 scan_matches没有匹配立刻 swap 回去这个“试错-回退”模式比自己枚举合法移动要省代码也比先判断哪两格交换会产生匹配更不容易算错。回退发生时整局步数不该扣减所以步数的计数要放在“确定合法交换”之后而不是点击时。4. 让桌面端消消乐更像“游戏”动画、计分与状态机4.1 用补间曲线在 pygame 里做“假动画”pygame 不是动画引擎它只提供一个每帧重绘的画布所有动效都要自己计算中间状态。常见做法是动画开始前记录初始值和目标值每帧根据时间进度插值播放完回到逻辑状态。逻辑状态先行动画只是把“最终结果”播放出来两者不要耦合在一个变量里。下落动画是最值得做的效果也是代码最简的。给每个下落中的图块记起始行、目标行、列和已播放时间class FallingTile: def __init__(self, kind, from_r, to_r, col, duration0.35): self.kind kind self.from_r from_r self.to_r to_r self.col col self.elapsed 0.0 self.duration duration self.alive True def update(self, dt): self.elapsed dt if self.elapsed self.duration: self.alive False def y(self): t min(self.elapsed / self.duration, 1.0) eased ease_out_cubic(t) return MARGIN (self.from_r (self.to_r - self.from_r) * eased) * CELL def ease_out_cubic(t): return 1 - (1 - t) ** 3ease_out_cubic让图块减速落地而不是匀速直线避免生硬感绘制时用 y() 得到当前像素 Yx 只依赖 col因此不用每次重新计算。所有 FallingTile 放在一个列表中每帧 update 后把 alive 为 False 的移除。注意 pygame 的clock.tick()返回的 dt 单位是毫秒update 里统一换算成秒再累加否则动画会快得看不见。消除瞬间的“闪一下再消失”效果可以用透明度动画。pygame 的 draw.rect 不能直接调 alpha常见做法是准备一张带 SRCALPHA 的临时 Surface逐帧填充越来越透明的颜色块blit 完丢弃。代价是每帧多一次小 Surface 的创建数量不多时 FPS 不会有波动。低于 20 个动效方块时先不要想优化60 FPS 撑得住。4.2 计分系统基础分、连击倍率与步数压力的数值模型期末大作业的计分不用复杂但要有“手感”。我在 9×9 棋盘上会用一张查表代替公式逻辑简单而且答辩时好讲消除块数基础分说明330最小匹配460一字型多消一5100T / L / 一字型极限≥6每块 30 再按块数累加让特殊消除有回报连锁加成cascade 次数为 1 时是基础分之后每次连锁在基础分上乘1 0.5 * (cascade - 1)。也就是第二次连锁 1.5 倍第三次 2.0 倍。这个模型给玩家的选择压力是“多造连锁而不是只消除三块”。实现上在 2.3 节的 while 循环里加一个计数即可cascade 0 total_cleared 0 matches board.scan_matches() while matches: cascade 1 total_cleared len(matches) board.clear_matches(matches) board.collapse_and_fill() matches board.scan_matches() base_score total_cleared * 30 if cascade 1: base_score int(base_score * (1 0.5 * (cascade - 1)))total_cleared 是本次操作中所有连锁消掉的图块总数用来算基础分cascade 只用来放大倍率两者不要混成一个变量。如果游戏有步数限制还可以在结算时把剩余步数乘以 10 加进总分让玩家为“减少步数完成消除”做出取舍。4.3 状态机菜单、对局、暂停、结算四种状态的切换状态机是游戏从“棋盘”升级成“游戏”的分界线。用枚举定义四种状态主循环里用当前状态分发事件和更新逻辑from enum import Enum class GameState(Enum): MENU 1 PLAYING 2 PAUSED 3 GAME_OVER 4 state GameState.MENU事件处理时每个状态只响应自己关心的输入。比如暂停状态下点击棋盘不触发交换只有 Esc/空格恢复结算状态只响应点击“再来一局”的按钮区域。if event.type pygame.KEYDOWN: if state GameState.PLAYING and event.key pygame.K_ESCAPE: state GameState.PAUSED elif state GameState.PAUSED and event.key pygame.K_ESCAPE: state GameState.PLAYINGPAUSED 状态下不需要更新动画时间绘制可以直接复用 PLAYING 的画面只额外覆盖一层半透明遮罩。这套 if 分支写起来最直接答辩时也容易解释清楚状态机保证了“界面与逻辑不会串台”而用枚举就是给每种状态一个名字比裸字符串对比更不易打错。菜单和结算界面不用单独建类各画几个按钮矩形把“点击位置落在哪个按钮里”的判定写在对应状态分支下就能满足大作业要求。5. 期末大作业的最后一公里打包 exe、写文档、准备答辩演示5.1 用 PyInstaller 打包含有资源文件的桌面端程序提交物里附一个 exe 往往比只给源码多拿不少印象分。pygame 项目打包的固定命令是pyinstaller --onefile --windowed --name Match3 main.py--windowed隐藏控制台窗口否则玩家会看到黑框--onefile把所有依赖打进单个可执行文件。打包时必须把图片、字体、音效等资源用下面的函数定位否则 exe 会找不到文件import sys, os def resource_path(relative): if hasattr(sys, _MEIPASS): return os.path.join(sys._MEIPASS, relative) return os.path.join(os.path.abspath(.), relative)如果你的程序用了音效PyInstaller 偶尔识别不全发声库运行后报 “mixer not initialized” 时在 main.py 开头先pygame.mixer.init()同时用 try 包住撞色提示音保证无声卡环境也能跑。5.2 文档说明写这四样运行环境、模块划分、核心流程、测试情况期末大作业的文档不用写成长篇论文但要有这四块内容运行环境Python 版本、pygame 版本、pip 安装命令模块划分Board 数据层、render 渲染层、main 主循环分别管什么核心流程图匹配扫描 → 消除 → 下落补新 → 再扫描以及测试情况。架构图可以用一个简单的目录树代替类图用表格列出主要方法和返回值比手画 UML 更清晰准确。核心算法段最好把第 2 章的 scan_matches 和连锁循环各贴一段进文档配一句话“这里的关键是扫描与消除分离方便连锁复用”。答辩时老师如果让你现场改参数只需告诉他改 Board 构造函数的 kind_count 或文件顶部的 CELL 常量几分钟就能看到效果。5.3 演示顺序先打一局再讲代码最后回答“为什么这么设计”现场演示最怕随机棋盘不给面子。预先在 fill_random 之外写一个 fill_from_seed 方法用固定的二维数组作为初始棋盘保证前三次操作一定产生连锁。开场先完整玩一局让老师看到棋盘、动画、计分在动再回到代码里打开 Board.py 讲“这其实不是一个文件的问题而是数据层和渲染层怎么分离的问题”。最后准备三个被问概率最高的答案为什么用整数表示图块为了查表与序列化方便为什么匹配和下落是两个阶段为了连锁循环不被动画打断如果棋盘扩到 20×20 会怎样扫描 O(R×C)、下落 O(R)仍是线性瓶颈会变成 pygame 的绘制调用次数需要改用批量 blit。本文还有配套的精品资源点击获取 python+pygame实现消消乐：从棋盘模型到游戏打包全攻略
简介这是一份基于Python与Pygame开发的桌面端消消乐游戏完整项目专为计算机相关专业学生的课程设计、期末大作业以及需要项目实战练习的初学者准备。项目由大三学生独立完成经导师指导并获99分高分评价代码结构清晰、注释完整确保可直接运行适合用来理解游戏循环、碰撞检测、界面渲染及资源管理等核心概念。压缩包共120个文件大小9.57MB主要包含4个Python源码文件、70个PNG图片素材、20个MP3与20个OGG音频文件以及YAML配置、Markdown说明文档等。不同格式素材分工明确图片用于游戏界面与元素绘制音频承载背景音乐与消除特效音文档则提供环境配置与运行说明便于快速上手。目前已有140人学习下载资源内附完整项目源码、文档说明及必要资源文件涵盖场景搭建、消除逻辑、音效触发等模块可直接作为期末答辩或作品展示的实用参考也方便二次修改与功能扩展。整体内容紧凑适合作为Python游戏开发入门的练手项目。1. 从期末大作业到可运行的桌面端游戏pythonpygame 消消乐到底要写什么先说一个很多人在提交期末大作业时的误会老师要看的不是你截图里的“运行成功”而是一个能现场点着玩的程序。基于 pythonpygame 的桌面端消消乐恰恰是游戏类选题里最稳的一种——规则简单代码量可控制视觉反馈直接而且三消机制天然适合用“数据结构 算法”的框架来拆解。这篇文章按我习惯的工程路径展开先搭一个严谨的棋盘数据模型再做匹配与下落算法然后用 pygame 渲染成可交互窗口最后补上动画、打包和文档细节。目标读者是正在选期末题目的学生以及想用 pygame 快速搭 2D 原型验证玩法的开发者。读完你会得到一套能逐行解释、也能现场改参数的游戏骨架。2. 消消乐的核心不是 pygame是网格模型与匹配算法2.1 把棋盘存成二维数组你的三消逻辑就完成了一半消消乐的本质是在 R 行 × C 列的网格里每个单元格放一种图块tile。这个网格在内存里最自然的映射就是一个二维数组例如board[row][col] kind。kind 可以是整数0红色1绿色2蓝色……也可以是枚举或字符串。用整数最省事因为后面做颜色映射、随机生成、序列化保存全部可以直接查表不需要在循环里写一堆字符串比较。我习惯用一个类把棋盘包起来而不是让 grid 散落在全局变量里。期末项目里最常见的 bug 就是“某个函数偷偷改了你不知道的列表”封装能把这种问题挡在外面。最小可运行的版本长这样import random class Board: def __init__(self, rows9, cols9): self.rows rows self.cols cols self.grid [[0] * cols for _ in range(rows)] self.kind_count 6 # 6 种图块 self.score 0 def fill_random(self): for r in range(self.rows): for c in range(self.cols): self.grid[r][c] random.randrange(self.kind_count) def swap(self, r1, c1, r2, c2): self.grid[r1][c1], self.grid[r2][c2] self.grid[r2][c2], self.grid[r1][c1]grid用列表推导式创建避免[[0] * cols] * rows这种会共享同一行内存的错误写法kind_count是 6 而不是 3 或 8是因为 6 种颜色在 9×9 网格上能保证“视觉区分度”和“自然生成匹配的概率”之间的平衡。图块种类太少棋盘会频繁出现连锁游戏节奏过碎种类太多玩家半天凑不出三连体感像在玩破解版。2.2 三连检测算法横竖两种扫描一次标记再统一消除三消的核心判定是在一行或一列里找到连续相同类型长度 ≥ 3 的图块。算法本身很笨横向逐行扫纵向逐列扫遇到连续的相同 kind 就累计累计到 3 就把这些格子标记为“待消除”。关键设计是扫描只做标记不要直接改 board消除动作放在统一入口里执行。def scan_matches(self): 返回所有需要消除的坐标集合类型为 set[(r, c)] matches set() # 横向从左到右扫描每一行 for r in range(self.rows): c 0 while c self.cols: kind self.grid[r][c] end c while end self.cols and self.grid[r][end] kind: end 1 if end - c 3: for cc in range(c, end): matches.add((r, cc)) c end # 纵向从上到下扫描每一列 for c in range(self.cols): r 0 while r self.rows: kind self.grid[r][c] end r while end self.rows and self.grid[end][c] kind: end 1 if end - c 3: for rr in range(r, end): matches.add((rr, c)) r end return matches用 while 而不是 for是为了在定位一段连续区间后能直接跳到 end避免 for 逐个移动导致重复判断。matches用 set 而不是 list是因为同一格可能同时被横向和纵向扫描命中比如 L 形消除set 天然去重。横纵扫描合并后才能拿到一次消除的完整集合差一步都会出现“消除后棋盘还在闪”的错觉。2.3 消除、下落、补新每次重组都是一个完整的循环经典的三消循环是扫描得到 matches → 把匹配格子置空用 -1 表示空→ 每一列把非空元素压到底部 → 从顶部补充随机图块 → 重新扫描直到没有新匹配。这个循环写成代码就是整个游戏的“物理引擎”。def clear_matches(self, matches): for r, c in matches: self.grid[r][c] -1 def collapse_and_fill(self): 一次下落与补新调用前必须清空待消除的格子 for c in range(self.cols): col_vals [] for r in range(self.rows - 1, -1, -1): if self.grid[r][c] ! -1: col_vals.append(self.grid[r][c]) # 从下往上收集 for r in range(self.rows - 1, -1, -1): if col_vals: self.grid[r][c] col_vals.pop(0) else: self.grid[r][c] random.randrange(self.kind_count)col_vals 从底部开始收集再倒着回填这样既能保证同一列内原有次序不被打乱又不需要新建一整块辅助矩阵。pop(0) 在列表头部弹出是 O(n) 操作但对 9×9 棋盘来说每次只有最多 9 个元素性能完全无感如果要把棋盘扩展到 30×30 以上可以加一个指针或改用双端队列。整个循环的驱动放在主循环里而不是 Board 内部用 while 一层层套matches board.scan_matches() while matches: board.clear_matches(matches) board.collapse_and_fill() matches board.scan_matches()这个 while 循环每转一圈就意味着发生了一次“连锁”cascade。连锁次数是后面计分系统里最重要的参数所以最好在这里用一个变量接住它而不是等动画做完再重新扫描——动画只负责“好看”逻辑层在棋盘变完那一刻就已经知道这次操作能得多少分了。Board 各方法的职责和调用关系可以用下面的表直接对应起来步骤操作Board 中的方法调用注意扫描标记匹配格scan_matches只读可在任意时刻重复调用清除把匹配格置为 -1clear_matches只处理 scan_matches 的返回值下落补新重组一列数据collapse_and_fill与 clear_matches 成对出现连锁检测再次扫描scan_matches直到返回空集合3. 用 pygame 把数组变成桌面端画面渲染管线与事件循环3.1 pygame 初始化与主循环每个 2D 桌面端游戏的固定骨架先补一句环境问题如果卡在pip install pygame上最常见的报错是error: failed to build pygame when getting requirements to build wheel。这通常是 Python 版本太旧或系统缺少编译工具链处理方法是升级到 Python 3.9 以上再安装新版 pip 会直接拉预编译 wheel 而不是现场编译。遇到这个错先不要怀疑代码几乎都是环境问题。pygame 程序的起点高度相似初始化模块、创建窗口、准备时钟然后进入一个“事件 → 更新 → 绘制”的死循环。很多新手把代码堆在 while 外面结果窗口白屏或卡死原因就是没遵守这个骨架。最小模板长这样import pygame from board import Board FPS 60 CELL 60 # 每个格子边长像素 MARGIN 40 # 棋盘外留白 ROWS COLS 9 pygame.init() screen pygame.display.set_mode(( COLS * CELL MARGIN * 2, ROWS * CELL MARGIN * 2 )) pygame.display.set_caption(Match-3 Python Pygame) clock pygame.time.Clock() board Board(ROWS, COLS) board.fill_random() running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False if event.type pygame.MOUSEBUTTONDOWN: pass # 第 3.3 节填充 # 更新逻辑动画进度、连锁结算、状态切换 screen.fill((30, 30, 40)) # 绘制draw_board(screen, board) pygame.display.flip() clock.tick(FPS) pygame.quit()set_mode 的尺寸直接由棋盘规模推出来保证窗口中间内容始终完整不会因为硬编码 800×600 而多出半格clock.tick(FPS) 控制帧率上限同时返回上一帧耗时这个值在动画里会被反复用到。事件循环里不要放耗时操作比如磁盘读写或者大量计算否则鼠标会飘pygame 的事件队列会越积越多。3.2 坐标变换从 (row, col) 到像素的差一步就可能画歪棋盘逻辑坐标和屏幕像素坐标是两套系统逻辑层用 (row, col)渲染层用 (x, y)。两者之间需要一个显式的换算函数否则你会在绘制、点击判定、动画插值三个地方各写一遍魔法数字最后改格大小时漏改一处整个棋盘错位。def cell_to_pixel(r, c): 逻辑坐标 - 屏幕左上角像素坐标 return MARGIN c * CELL, MARGIN r * CELL def pixel_to_cell(pos): 屏幕坐标 - 逻辑坐标越界时返回 None x, y pos c (x - MARGIN) // CELL r (y - MARGIN) // CELL if 0 r ROWS and 0 c COLS: return r, c return None, None绘制棋盘时把 grid 里的每个 kind 映射成颜色块COLORS [ (255, 90, 90), # 0 红 (90, 200, 90), # 1 绿 (90, 140, 255), # 2 蓝 (250, 210, 80), # 3 黄 (200, 120, 255), # 4 紫 (255, 160, 80), # 5 橙 ] def draw_board(screen, board): for r in range(board.rows): for c in range(board.cols): kind board.grid[r][c] if kind 0: continue x, y cell_to_pixel(r, c) pygame.draw.rect( screen, COLORS[kind], pygame.Rect(x 2, y 2, CELL - 4, CELL - 4), border_radius8 )这里用圆角矩形代替贴图是为了省去美术素材的版权问题和尺寸处理。想换成图片时把 COLORS[kind] 换成预先加载的tile_images[kind]再用screen.blit(img, (x, y))输出即可。rect 的 x2 和 CELL-4 是为了让相邻方块之间留出 2 像素的缝隙三消游戏的棋盘如果没有缝隙视觉上会糊成一整片色块连击时很难看清边界。绘制相关的几个常量集中放在文件顶部方便答辩现场调参常量建议值作用CELL60每格边长像素MARGIN40棋盘与窗口边缘间距FPS60帧率上限动画计时基准COLORS 长度与 kind_count 一致颜色映射表必须覆盖所有图块种类3.3 鼠标交互选中、交换、无效操作回退的执行顺序pygame 的鼠标事件只告诉你“什么位置发生了什么”至于这个位置落在哪个格子里、该格与已选格是否相邻、交换后是否合法都是游戏逻辑层要回答的问题。我一般把处理顺序固定为未选择时点击 - 选中已选择时点击相邻格 - 尝试交换交换后没有匹配 - 换回去。selected None def handle_click(pos): global selected r, c pixel_to_cell(pos) if r is None or c is None: return if selected is None: selected (r, c) return r0, c0 selected selected None if abs(r0 - r) abs(c0 - c) ! 1: return # 不相邻重新选择 board.swap(r0, c0, r, c) if not board.scan_matches(): board.swap(r0, c0, r, c) # 无效交换回退 else: # 进入连锁清除循环并通知动画层开始播放 passabs(r0-r) abs(c0-c) 1 是曼哈顿距离的相邻判定它同时排除了对角线格子和斜向误触。交换后先 scan_matches没有匹配立刻 swap 回去这个“试错-回退”模式比自己枚举合法移动要省代码也比先判断哪两格交换会产生匹配更不容易算错。回退发生时整局步数不该扣减所以步数的计数要放在“确定合法交换”之后而不是点击时。4. 让桌面端消消乐更像“游戏”动画、计分与状态机4.1 用补间曲线在 pygame 里做“假动画”pygame 不是动画引擎它只提供一个每帧重绘的画布所有动效都要自己计算中间状态。常见做法是动画开始前记录初始值和目标值每帧根据时间进度插值播放完回到逻辑状态。逻辑状态先行动画只是把“最终结果”播放出来两者不要耦合在一个变量里。下落动画是最值得做的效果也是代码最简的。给每个下落中的图块记起始行、目标行、列和已播放时间class FallingTile: def __init__(self, kind, from_r, to_r, col, duration0.35): self.kind kind self.from_r from_r self.to_r to_r self.col col self.elapsed 0.0 self.duration duration self.alive True def update(self, dt): self.elapsed dt if self.elapsed self.duration: self.alive False def y(self): t min(self.elapsed / self.duration, 1.0) eased ease_out_cubic(t) return MARGIN (self.from_r (self.to_r - self.from_r) * eased) * CELL def ease_out_cubic(t): return 1 - (1 - t) ** 3ease_out_cubic让图块减速落地而不是匀速直线避免生硬感绘制时用 y() 得到当前像素 Yx 只依赖 col因此不用每次重新计算。所有 FallingTile 放在一个列表中每帧 update 后把 alive 为 False 的移除。注意 pygame 的clock.tick()返回的 dt 单位是毫秒update 里统一换算成秒再累加否则动画会快得看不见。消除瞬间的“闪一下再消失”效果可以用透明度动画。pygame 的 draw.rect 不能直接调 alpha常见做法是准备一张带 SRCALPHA 的临时 Surface逐帧填充越来越透明的颜色块blit 完丢弃。代价是每帧多一次小 Surface 的创建数量不多时 FPS 不会有波动。低于 20 个动效方块时先不要想优化60 FPS 撑得住。4.2 计分系统基础分、连击倍率与步数压力的数值模型期末大作业的计分不用复杂但要有“手感”。我在 9×9 棋盘上会用一张查表代替公式逻辑简单而且答辩时好讲消除块数基础分说明330最小匹配460一字型多消一5100T / L / 一字型极限≥6每块 30 再按块数累加让特殊消除有回报连锁加成cascade 次数为 1 时是基础分之后每次连锁在基础分上乘1 0.5 * (cascade - 1)。也就是第二次连锁 1.5 倍第三次 2.0 倍。这个模型给玩家的选择压力是“多造连锁而不是只消除三块”。实现上在 2.3 节的 while 循环里加一个计数即可cascade 0 total_cleared 0 matches board.scan_matches() while matches: cascade 1 total_cleared len(matches) board.clear_matches(matches) board.collapse_and_fill() matches board.scan_matches() base_score total_cleared * 30 if cascade 1: base_score int(base_score * (1 0.5 * (cascade - 1)))total_cleared 是本次操作中所有连锁消掉的图块总数用来算基础分cascade 只用来放大倍率两者不要混成一个变量。如果游戏有步数限制还可以在结算时把剩余步数乘以 10 加进总分让玩家为“减少步数完成消除”做出取舍。4.3 状态机菜单、对局、暂停、结算四种状态的切换状态机是游戏从“棋盘”升级成“游戏”的分界线。用枚举定义四种状态主循环里用当前状态分发事件和更新逻辑from enum import Enum class GameState(Enum): MENU 1 PLAYING 2 PAUSED 3 GAME_OVER 4 state GameState.MENU事件处理时每个状态只响应自己关心的输入。比如暂停状态下点击棋盘不触发交换只有 Esc/空格恢复结算状态只响应点击“再来一局”的按钮区域。if event.type pygame.KEYDOWN: if state GameState.PLAYING and event.key pygame.K_ESCAPE: state GameState.PAUSED elif state GameState.PAUSED and event.key pygame.K_ESCAPE: state GameState.PLAYINGPAUSED 状态下不需要更新动画时间绘制可以直接复用 PLAYING 的画面只额外覆盖一层半透明遮罩。这套 if 分支写起来最直接答辩时也容易解释清楚状态机保证了“界面与逻辑不会串台”而用枚举就是给每种状态一个名字比裸字符串对比更不易打错。菜单和结算界面不用单独建类各画几个按钮矩形把“点击位置落在哪个按钮里”的判定写在对应状态分支下就能满足大作业要求。5. 期末大作业的最后一公里打包 exe、写文档、准备答辩演示5.1 用 PyInstaller 打包含有资源文件的桌面端程序提交物里附一个 exe 往往比只给源码多拿不少印象分。pygame 项目打包的固定命令是pyinstaller --onefile --windowed --name Match3 main.py--windowed隐藏控制台窗口否则玩家会看到黑框--onefile把所有依赖打进单个可执行文件。打包时必须把图片、字体、音效等资源用下面的函数定位否则 exe 会找不到文件import sys, os def resource_path(relative): if hasattr(sys, _MEIPASS): return os.path.join(sys._MEIPASS, relative) return os.path.join(os.path.abspath(.), relative)如果你的程序用了音效PyInstaller 偶尔识别不全发声库运行后报 “mixer not initialized” 时在 main.py 开头先pygame.mixer.init()同时用 try 包住撞色提示音保证无声卡环境也能跑。5.2 文档说明写这四样运行环境、模块划分、核心流程、测试情况期末大作业的文档不用写成长篇论文但要有这四块内容运行环境Python 版本、pygame 版本、pip 安装命令模块划分Board 数据层、render 渲染层、main 主循环分别管什么核心流程图匹配扫描 → 消除 → 下落补新 → 再扫描以及测试情况。架构图可以用一个简单的目录树代替类图用表格列出主要方法和返回值比手画 UML 更清晰准确。核心算法段最好把第 2 章的 scan_matches 和连锁循环各贴一段进文档配一句话“这里的关键是扫描与消除分离方便连锁复用”。答辩时老师如果让你现场改参数只需告诉他改 Board 构造函数的 kind_count 或文件顶部的 CELL 常量几分钟就能看到效果。5.3 演示顺序先打一局再讲代码最后回答“为什么这么设计”现场演示最怕随机棋盘不给面子。预先在 fill_random 之外写一个 fill_from_seed 方法用固定的二维数组作为初始棋盘保证前三次操作一定产生连锁。开场先完整玩一局让老师看到棋盘、动画、计分在动再回到代码里打开 Board.py 讲“这其实不是一个文件的问题而是数据层和渲染层怎么分离的问题”。最后准备三个被问概率最高的答案为什么用整数表示图块为了查表与序列化方便为什么匹配和下落是两个阶段为了连锁循环不被动画打断如果棋盘扩到 20×20 会怎样扫描 O(R×C)、下落 O(R)仍是线性瓶颈会变成 pygame 的绘制调用次数需要改用批量 blit。本文还有配套的精品资源点击获取