简介一份基于Python实现贪吃蛇小游戏的完整毕业设计报告面向计算机类专业需要完成课程设计或毕业设计的在校学生也适合对Pygame游戏开发感兴趣的入门者。报告以Python 3.8与PyCharm为开发环境围绕Pygame模块展开系统梳理了游戏产业背景、可行性分析、界面与功能设计、核心代码实现、测试调试以及性能优化等流程详细讲解蛇的移动、食物生成、碰撞检测、得分显示等基础逻辑并拓展了多级难度、速度调整等创新点还配有框架设计图和画面展示结构清晰便于对照理解。资源包为单个docx文档文件总数1个约197KB内容可直接修改复用作为报告模板或代码思路参考都很方便。目前已有3753人学习下载适合需要快速搭建同类小游戏项目、梳理毕业设计章节或学习Pygame基础用法的读者。1. 用Python实现贪吃蛇小游戏毕业设计为什么选它毕业设计选“用Python实现贪吃蛇小游戏”往往是很多人的第一个念头也是被劝退最多的题目。选它是因为工作量可控不碰数据库、不碰网络协议核心就一块游戏窗口加几段逻辑Python 语法基础扎扎实实能写出来。但真正动手才发现贪吃蛇把游戏开发里的硬骨头全占了状态循环、事件响应、碰撞检测、坐标换算、渲染时序哪个环节糊弄过去运行起来就是黑屏、闪退、蛇身断裂。与其说是做小游戏不如说是用最小成本把“程序是怎么转起来”这件事完整走了一遍。这个题适合三类人一是刚学完 Python 基础、想找一个小而完整的练手项目的人二是正在赶毕业设计、需要快速跑通又怕被答辩老师追问细节的学生三是想给简历补一个可视化项目、但不想碰 web 前后端的开发者。下面的内容不讲解题式废话直接按“环境搭建→数据结构→主循环→排错→进阶”的路线把能抄作业的代码和参数都放出来。2. 搭建开发环境与选型pygame 还是 tkinter2.1 为什么优先用 pygame时间与深度上的平衡做贪吃蛇最常被问到的第一个选择题是“用 pygame 还是 tkinter”。tkinter 是 Python 自带的 GUI 库不用额外安装画矩形、响应按键都能做适合 200 行以内的极简版本。但 tkinter 的硬伤是渲染机制它是事件驱动的刷新屏幕要靠 mainloop 反复调度做连续动画要么卡顿要么逻辑别扭想实现流畅的蛇身移动你得自己用 after 函数模拟时钟游戏循环写得既不像游戏也不像桌面软件。pygame 是专门为 2D 游戏设计的媒体库把显示窗口、图片加载、音效播放、时钟控制都封装好了。它有一层最关键的抽象叫 Surface你只管往内存里画画完再统一 flip 到屏幕天然契合“更新状态→渲染画面→等待下一帧”的游戏循环。错误做法是混着学两个库时间花在库的差异上游戏逻辑反而没写扎实。我的建议是直接上 pygame它是 Python 游戏开发的事实标准网上可查的贪吃蛇开源案例 80% 基于它毕业设计后期想加音效、动画、AI 自动寻路都有现成写法支撑。安装 pygame 之前先把 Python 环境确认好。我见过太多失败案例不是代码问题是 pip 装包时的 Python 版本或权限问题导致的。用下面的命令在命令行里先看版本python --version py -m pip --version注意Windows 系统下推荐用py -m pip而不是裸pip。原因是很多机器装了多个 Python裸写pip可能装到别的解释器上代码里import pygame却还是 ModuleNotFoundError。如果你看到 pip 对应的路径和你python对应的路径不一致就是典型的“黑匣子装错包”场景。2.2 最小可运行环境安装 pygame 并验证确认 Python 版本在 3.8 以上后直接装 pygamepy -m pip install pygame装完之后别急着写游戏先做一次 10 秒钟的冒烟测试import pygame # 初始化 pygame 所有模块返回成功/失败元组 ok, fail pygame.init() print(f初始化成功模块数: {ok}, 失败数: {fail}) # 创建窗口宽 600高 600单位是像素 screen pygame.display.set_mode((600, 600)) pygame.display.set_caption(冒烟测试窗口) # 拿一个字体对象画文字确认渲染可用 font pygame.font.SysFont(simhei, 48) text font.render(pygame OK, True, (255, 255, 255)) screen.blit(text, (150, 270)) pygame.display.flip() # 挂起 2 秒window 打开后能看到白字就说明环境正常 pygame.time.wait(2000) pygame.quit()这段代码里有两个值得留意的参数。set_mode((600, 600))的元组是窗口逻辑宽高你后续画蛇和食物用的坐标系会按这个尺寸换算建议一开始就定好不要在开发中途反复改否则所有坐标相关的代码都要跟着重算。SysFont(simhei, 48)里字体名也要注意Windows 自带“黑体”对应的英文名是 simheiLinux 上若找不到这个字体名需要把第一个参数占位改成pygame.font.get_default_font()。这是很多人在 Linux 上跑样例报错font not found的原因。跑通冒烟测试后你的开发环境就具备了写完整游戏的全部条件。接下来要把贪吃蛇拆成几个独立模块不要上来就写一个 500 行的大文件后面排错会非常痛苦。3. 把贪吃蛇拆成四块网格、蛇身、食物与移动逻辑3.1 用固定网格代替像素坐标让碰撞检测变简单贪吃蛇最容易犯的方向性错误是“用像素坐标做碰撞”。像素坐标下的蛇身每个点都是自由浮动的蛇头撞到身体某一段的判定要遍历所有像素点而蛇身每帧还在移动误差和计算量都失控。正确的做法是先把屏幕划分成固定网格蛇的每一节都只落在整数网格点上移动就是坐标加减 1碰撞检测就是元组相等判断。下面这段是网格参数与游戏常量的定义我习惯单独放一个config.py# config.py # 网格逻辑尺寸20x20意味着游戏区最多有 400 个格子 GRID_WIDTH 20 GRID_HEIGHT 20 # 每个格子渲染成 30x30 像素方块窗口大小就是 600x600 CELL_SIZE 30 # 每秒移动多少格数值越大蛇跑得越快 BASE_SPEED 8 # 方向常量方便后续比较 UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0)这里把CELL_SIZE定为 30 是综合考虑后的选择。太小的格子比如 10 像素食物画出来很难看清太大比如 60 像素则窗口要开满屏才能容纳 20 列。更重要的是窗口宽度GRID_WIDTH * CELL_SIZE恰好是 600这个尺寸在大多数笔记本屏幕上完整显示不需要滚动条答辩现场投屏也不会被截断。网格宽高设定 20x20 的好处是蛇身最长可以到 400 节整局游戏玩到后期复杂度依然在可控范围。网格化设计带来的第二个好处是把“蛇头撞墙”的判定从像素边界判断简化为索引越界判断。我一般用一句话说明规则注意网格坐标 (x, y) 中x 表示第几列y 表示第几行。画图时 x 对应屏幕横向y 对应屏幕纵向。后面所有代码都遵循这个约定避免渲染时方向颠倒。3.2 蛇的数据结构用双端队列存蛇身移动时头进尾出蛇的移动本质是“头前进一步尾缩回一格”整体看起来像整条蛇往前平移。做这个逻辑Python 原生的 list 也能实现但 list 在头部插入的时间复杂度是 O(n)蛇身一长每帧都要复制整个列表游戏就会掉帧。更合适的数据结构是collections.deque它从两端增删元素都是 O(1)而且维护一个 deque 就能同时完成“头进尾出”两个操作。# snake.py from collections import deque from config import UP, DOWN, LEFT, RIGHT class Snake: def __init__(self): # 蛇身顺序deque[0] 是蛇头deque[-1] 是蛇尾 # 初始位置放在网格中央偏右长度为 3方向向左不碰墙 self.body deque([(12, 10), (11, 10), (10, 10)]) self.direction RIGHT def head(self): return self.body[0] def move(self): # 关键步骤一弹出旧尾巴 self.body.pop() # 关键步骤二计算新蛇头坐标 x, y self.head() dx, dy self.direction new_head (x dx, y dy) # 关键步骤三把新头插到队首 self.body.appendleft(new_head) def grow(self): # 吃到食物时先复制当前的尾巴再执行普通移动 # 因为 move 会弹掉旧尾巴grow 里先手动补回一个尾部节点 tail self.body[-1] self.move() self.body.append(tail) def hit_self(self): # 蛇头坐标如果在 body 里出现不止一次说明撞到自己 head self.head() return head in list(self.body)[1:]这段代码里move和grow的配合是最容易写错的地方。如果你在grow里先调move再追加尾巴看起来长度只加了 1但追加的坐标未必是正确的延续方向。正确思路是grow的任务是先让蛇正常走一格再把刚才被pop掉的旧尾巴补回来这样总长度净增 1视觉上就是“尾巴后面多了一截”。很多翻车现场是直接把旧尾巴 append 到队尾导致蛇身凭空长出凸起每次吃食物后蛇的形状都畸变。hit_self里的list(self.body)[1:]每次碰撞检测都要做一次转换因为deque不支持切片下标操作而碰撞检测只在移动后执行一次O(n) 的代价在 400 格上限内可以忽略。如果你想更快可以在move里维护一个set同步存蛇身坐标但毕业设计阶段不必做这个优化加了反而增加两个容器之间的一致性维护成本。3.3 食物生成避开蛇身坐标的随机算法食物生成的朴素写法是random.randint(0, GRID_WIDTH - 1)生成 x 和 y然后检查是否落在蛇身上如果落上就重新生成。问题是“重新生成”怎么写很多人会写成固定次数的 for 循环比如重试 10 次还失败就随便放一个坐标结果后期蛇身很长时食物大概率生成在蛇身上游戏行为变得诡异。正确的写法是无限重试直到生成一个有效坐标。400 格的棋盘里蛇身能占满大半个场地的概率极低无限重试在事实上不会死循环# food.py import random from config import GRID_WIDTH, GRID_HEIGHT class Food: def __init__(self): self.position None def spawn(self, snake_body): # 把蛇身坐标转成 set 集合in 判断 O(1) occ set(snake_body) while True: x random.randrange(GRID_WIDTH) y random.randrange(GRID_HEIGHT) if (x, y) not in occ: self.position (x, y) returnrandom.randrange(GRID_WIDTH)和random.randint(0, GRID_WIDTH - 1)等价但语义更直白。坐标转成 set 是关键如果直接用(x, y) in snake_bodydeque 的成员查找是 O(n) 的随机重试的碰撞检查会随蛇身变长越拖越慢。把蛇身坐标一次性转成 set 后每次判断都是 O(1)这个细节就是蛇长到 200 节以后游戏流畅度的分水岭。食物生成还要注意一个体验细节不要把食物生成在蛇头正前方紧邻的一格。因为蛇每帧至少移动一格食物在头上脸生成玩家还没反应蛇头就压过了食物视觉上食物“瞬移”了。处理方式是在spawn里额外排除蛇头方向相邻坐标但毕设论文里也可以不做把它写在“已知缺陷与改进”章节里反而显得你有边界意识。4. 游戏主循环与事件处理单线程循环怎么做到实时响应4.1 主循环骨架时钟、事件、更新、渲染pygame 的游戏本质是一个死循环每轮循环做四件事处理用户输入事件、更新游戏状态、重绘画面、控制帧率。初学者最容易犯的错是把事件处理写在循环外面或者用time.sleep控制速度这两者都会让游戏窗口“假死”。正确的主循环骨架# main.py import pygame from config import GRID_WIDTH, GRID_HEIGHT, CELL_SIZE, BASE_SPEED from snake import Snake from food import Food pygame.init() screen pygame.display.set_mode((GRID_WIDTH * CELL_SIZE, GRID_HEIGHT * CELL_SIZE)) pygame.display.set_caption(贪吃蛇) clock pygame.time.Clock() snake Snake() food Food() food.spawn(snake.body) running True while running: # 第一步把这一帧产生的所有事件取出来处理 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.KEYDOWN: if event.key pygame.K_UP and snake.direction ! DOWN: snake.direction UP elif event.key pygame.K_DOWN and snake.direction ! UP: snake.direction DOWN elif event.key pygame.K_LEFT and snake.direction ! RIGHT: snake.direction LEFT elif event.key pygame.K_RIGHT and snake.direction ! LEFT: snake.direction RIGHT # 第二步更新状态 snake.move() # 第三步判断迟到食物 if snake.head() food.position: snake.grow() food.spawn(snake.body) # 第四步判断死亡条件 if snake.hit_self(): running False # 第五步画背景、蛇、食物 screen.fill((24, 24, 24)) for x, y in snake.body: pygame.draw.rect( screen, (0, 200, 0), (x * CELL_SIZE, y * CELL_SIZE, CELL_SIZE, CELL_SIZE) ) fx, fy food.position pygame.draw.rect( screen, (200, 0, 0), (fx * CELL_SIZE, fy * CELL_SIZE, CELL_SIZE, CELL_SIZE) ) pygame.display.flip() # 第六步控制帧率也就是蛇的速度 clock.tick(BASE_SPEED) pygame.quit()循环里最容易被忽略的是事件处理的“排队”特性。pygame.event.get()拿到的是一瞬间缓冲的事件列表如果你在循环里加time.sleep(0.1)sleep 期间产生按键事件不会消失而是堆积在缓冲区等 sleep 结束一次性全挤出来表现就是玩家按了一下是因为之前按键队列太长。所以速度控制必须交给clock.tick(BASE_SPEED)它会在每帧末尽量保持帧间隔为1000 / BASE_SPEED毫秒既不占用 CPU也不会吞事件。4.2 方向输入防翻车四方向限制与按键队列主循环里对方向键的处理藏着贪吃蛇最经典的崩溃场景快速连按两下方向键比如蛇向右移动时玩家按了上再按左程序先接收“向上”再接收“向左”可此时蛇头还没完成第二次转向向左直接变成“回头咬自己”。这被称为 180 度掉头问题。解决要在两个层面同时做。第一层是当前帧的方向判断代码里已经写了snake.direction ! DOWN这类反向排除。但注意这个判断只能挡”与当前相反”的方向挡不住“蛇还没转向就再次转向”的连击。第二层是增加一个“方向缓冲区”把一轮帧里产生的按键方向存进队列每帧只消费一个方向# 在主循环外初始化 direction_queue [] # 事件处理里改成入队 elif event.key pygame.K_UP: direction_queue.append(UP) elif event.key pygame.K_DOWN: direction_queue.append(DOWN) # 状态更新前从队列里取一个方向 if direction_queue: new_dir direction_queue.pop(0) if (new_dir[0] snake.direction[0], new_dir[1] snake.direction[1]) ! (0, 0): snake.direction new_dir队列长度超过 2 时可以把队首之外的元素清掉因为玩家在一瞬间内按出的第三个方向基本是误触不需要为了它额外“加速转向”。这是很多游戏手柄输入里默认的一个经验值你可以在报告里写“通过限制方向缓冲队列长度为 2兼顾了响应速度与防误触”。4.3 得分与游戏结算显示、速度提升、重开逻辑一个能交差的贪吃蛇不能只有蛇和食物得有分数显示、死亡提示和重新开始的入口。分数直接用一个整数变量累加每次吃到食物加 10这是最常见也最保守的方案也有按蛇身长度算分的但答辩时会多一个“为什么长度即分数”的解释成本没必要。速度提升逻辑是毕设里容易出彩的点。很多人写的是“每吃一个食物就加快 1 帧”结果蛇到后期快到没法玩。更合理的设计是按分段提速每吃 5 个食物BASE_SPEED增加 1最高封顶 20。这个参数可以做成常量放在配置里# 主循环状态更新部分 if snake.head() food.position: snake.grow() score 10 eat_count 1 if eat_count % 5 0 and BASE_SPEED 20: speed 1重开逻辑的常见做法是在游戏结束后显示Game Over, 按 R 重新开始。实现时不要用recursion递归重启主循环那会爆栈。正确方式是加一个game_over标志位把主循环整体包进while not game_over的嵌套结构或者用running状态机分成 PLAYING / DEAD / RESTART 三种状态。最简单的写法是把整个主循环放进一个while True的大循环内部while running跑单局死亡后跳出内层循环并在外层等待按键。5. 贪吃蛇常见问题与避坑代码能跑不代表交得出5.1 蛇本身是怎么回事现象蛇前进一格后身体从中间断开或者蛇头走了但整条蛇拉伸成一条连续长条看起来不像 3 节而像一整块。原因move()里先appendleft新头再pop旧尾顺序搞反了。若先插头再弹尾尾部弹出的其实是旧蛇头后的第二节蛇身长度不变但形状错位。如果忘了弹尾蛇每帧都在变长视觉上就是不断拉伸。本质是“弹出旧尾必须在插入新头之前”。解决参照 3.2 的代码严格先pop()再appendleft()。排查时不要看渲染直接打印snake.body的坐标内容对照上一步坐标变化一眼就能定位是pop丢了还是appendleft多了。5.2 食物生成在蛇身上游戏开局就死循环现象程序运行后窗口黑屏CPU 占用率拉满甚至 cmd 窗口无报错但卡死。原因random.randint的取值上限写成GRID_WIDTH随机坐标可能出现x20或y20超出了网格索引范围。还有一种可能是spawn里判断蛇身用的是snake.body退化后的坐标但蛇身更新后又把食物覆盖了食物和蛇头重叠主循环里snake.head() food.position永远成立每帧都在“吃食物”。解决第一步把生成坐标的打印放进去看取值范围。第二步在spawn里打印蛇身 set 的大小确认坐标空间确实还有空位。注意蛇身长度等于GRID_WIDTH * GRID_HEIGHT时无限重试会变成真死循环需要在spawn入口加一层判断若蛇长已达上线直接判定胜利退出。5.3 按键方向失灵快速转向不响应现象蛇向右走快速按“上左”蛇没有向左掉头而是继续向右或者直接反向撞到自己。原因事件处理里方向判断的本质是“过滤掉非法反向”但对“还没执行的转向”没有缓冲。加上方向队列后还要注意队列里的新方向是否与队列末尾的方向相反。比如队列里先有 UP再收到 DOWN从蛇的视角看这两个方向抵消了正确的处理是弹出两个方向保持原方向前进而不是执行 180 度反转。解决在入队时检查new_dir与队列末尾方向是否形成反向冲突若冲突则直接丢弃新的方向。这个逻辑写过一次后整个方向系统就稳定了。答辩时这段可以当成“输入防抖”的亮点讲。5.4 报告里贴代码的边界别把整份源码贴进论文现象毕业设计报告查重率爆表或者答辩老师说“源码里面没有注释你是从开源项目抄的吗”。原因很多学生下载开源的贪吃蛇项目把 main.py 原封不动贴进报告连变量命名风格都不一样。技术答辩时老师问“为什么用 deque 不用 list”或“食物生成为何用 while True”答不上来。解决报告里只贴三类代码——核心数据结构定义Snake 类、主循环骨架、碰撞检测函数。每段代码下面写“设计理由”和“性能说明”讲清楚 O(1) vs O(n) 的取舍。把完整的运行代码放附录并注明设计思路这说明是你自己的改造而非抄粘贴。以我的经验答辩老师更看重“你改过什么”而不是“你写了多少行”能在报告里清晰列出这个版本和参考版本的差异就已经是合格的毕设。6. 进阶玩法与验证从能玩到能答辩6.1 存档与读档把最高分和当前局写到本地想让它从“一个小游戏”变成“一个完成了完整数据闭环的小系统”最轻量的方法是加一个本地存档。用 JSON 比 txt 更方便因为字典结构直接序列化不用自己拼字符串解析。import json, os SAVE_FILE snake_save.json def save_score(best_score): data {best: best_score} with open(SAVE_FILE, w, encodingutf-8) as f: json.dump(data, f, ensure_asciiFalse, indent2) def load_score(): if not os.path.exists(SAVE_FILE): return 0 with open(SAVE_FILE, r, encodingutf-8) as f: data json.load(f) return data.get(best, 0)存档路径不要写死成绝对路径用相对路径依赖运行目录。如果你把项目挪到别的机器相对路径下的snake_save.json仍然正常。在main.py里每局结束把score和best比较后写盘这个动作是很好的“数据落盘”练习也是答辩时最容易演示的功能。最后展示时先跑一局关掉程序再重新打开让裁判看到最高分被保留比任何 PPT 截图都有说服力。6.2 让答辩更有料记录每局步数与存活时长最高分之外我更建议加两个统计维度的埋点本局步数和游戏时长。步数在每次snake.move()后累加时长用pygame.time.get_ticks()记录开局时刻结束时取差值换算为秒。把它们写进结束画面的文字里构成“本局步数 / 本局用时 / 历史最高分”三行信息。这三个指标在答辩时能撑起一组有意义的提问步数与长度对应游戏节奏快慢时长与速度提升对应难度曲线设计。你可以把“每吃 5 个食物提速一次”设计成因变量记录步数和时长作为验证数据。如果坚持用手动测试 3 局收集到的数据点足以绘制最简单的难度曲线表而不必编造数字。我这几年带毕设最深的感受是很多学生把时间花在调参美化上忽略了对游戏自身的结构拆解。一个能在报告里画出“状态循环图 数据结构图 事件响应顺序图”的贪吃蛇比一个画了炫酷背景但没有文档的项目好答辩十倍。哪怕你最终只用了本文里六七成的代码也务必把网格坐标、deque 选型理由、方向防抖这三个设计点吃透。代码可以调试思路不行就只能翻车重来。贪吃蛇虽小但一套完整的小型应用该有的部件它都有把它讲清楚你写下一款游戏或工具的底气就有了。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/2 19:21:46 · 阅读 1.2k Python贪吃蛇游戏开发：从环境搭建到毕业设计避坑指南
简介一份基于Python实现贪吃蛇小游戏的完整毕业设计报告面向计算机类专业需要完成课程设计或毕业设计的在校学生也适合对Pygame游戏开发感兴趣的入门者。报告以Python 3.8与PyCharm为开发环境围绕Pygame模块展开系统梳理了游戏产业背景、可行性分析、界面与功能设计、核心代码实现、测试调试以及性能优化等流程详细讲解蛇的移动、食物生成、碰撞检测、得分显示等基础逻辑并拓展了多级难度、速度调整等创新点还配有框架设计图和画面展示结构清晰便于对照理解。资源包为单个docx文档文件总数1个约197KB内容可直接修改复用作为报告模板或代码思路参考都很方便。目前已有3753人学习下载适合需要快速搭建同类小游戏项目、梳理毕业设计章节或学习Pygame基础用法的读者。1. 用Python实现贪吃蛇小游戏毕业设计为什么选它毕业设计选“用Python实现贪吃蛇小游戏”往往是很多人的第一个念头也是被劝退最多的题目。选它是因为工作量可控不碰数据库、不碰网络协议核心就一块游戏窗口加几段逻辑Python 语法基础扎扎实实能写出来。但真正动手才发现贪吃蛇把游戏开发里的硬骨头全占了状态循环、事件响应、碰撞检测、坐标换算、渲染时序哪个环节糊弄过去运行起来就是黑屏、闪退、蛇身断裂。与其说是做小游戏不如说是用最小成本把“程序是怎么转起来”这件事完整走了一遍。这个题适合三类人一是刚学完 Python 基础、想找一个小而完整的练手项目的人二是正在赶毕业设计、需要快速跑通又怕被答辩老师追问细节的学生三是想给简历补一个可视化项目、但不想碰 web 前后端的开发者。下面的内容不讲解题式废话直接按“环境搭建→数据结构→主循环→排错→进阶”的路线把能抄作业的代码和参数都放出来。2. 搭建开发环境与选型pygame 还是 tkinter2.1 为什么优先用 pygame时间与深度上的平衡做贪吃蛇最常被问到的第一个选择题是“用 pygame 还是 tkinter”。tkinter 是 Python 自带的 GUI 库不用额外安装画矩形、响应按键都能做适合 200 行以内的极简版本。但 tkinter 的硬伤是渲染机制它是事件驱动的刷新屏幕要靠 mainloop 反复调度做连续动画要么卡顿要么逻辑别扭想实现流畅的蛇身移动你得自己用 after 函数模拟时钟游戏循环写得既不像游戏也不像桌面软件。pygame 是专门为 2D 游戏设计的媒体库把显示窗口、图片加载、音效播放、时钟控制都封装好了。它有一层最关键的抽象叫 Surface你只管往内存里画画完再统一 flip 到屏幕天然契合“更新状态→渲染画面→等待下一帧”的游戏循环。错误做法是混着学两个库时间花在库的差异上游戏逻辑反而没写扎实。我的建议是直接上 pygame它是 Python 游戏开发的事实标准网上可查的贪吃蛇开源案例 80% 基于它毕业设计后期想加音效、动画、AI 自动寻路都有现成写法支撑。安装 pygame 之前先把 Python 环境确认好。我见过太多失败案例不是代码问题是 pip 装包时的 Python 版本或权限问题导致的。用下面的命令在命令行里先看版本python --version py -m pip --version注意Windows 系统下推荐用py -m pip而不是裸pip。原因是很多机器装了多个 Python裸写pip可能装到别的解释器上代码里import pygame却还是 ModuleNotFoundError。如果你看到 pip 对应的路径和你python对应的路径不一致就是典型的“黑匣子装错包”场景。2.2 最小可运行环境安装 pygame 并验证确认 Python 版本在 3.8 以上后直接装 pygamepy -m pip install pygame装完之后别急着写游戏先做一次 10 秒钟的冒烟测试import pygame # 初始化 pygame 所有模块返回成功/失败元组 ok, fail pygame.init() print(f初始化成功模块数: {ok}, 失败数: {fail}) # 创建窗口宽 600高 600单位是像素 screen pygame.display.set_mode((600, 600)) pygame.display.set_caption(冒烟测试窗口) # 拿一个字体对象画文字确认渲染可用 font pygame.font.SysFont(simhei, 48) text font.render(pygame OK, True, (255, 255, 255)) screen.blit(text, (150, 270)) pygame.display.flip() # 挂起 2 秒window 打开后能看到白字就说明环境正常 pygame.time.wait(2000) pygame.quit()这段代码里有两个值得留意的参数。set_mode((600, 600))的元组是窗口逻辑宽高你后续画蛇和食物用的坐标系会按这个尺寸换算建议一开始就定好不要在开发中途反复改否则所有坐标相关的代码都要跟着重算。SysFont(simhei, 48)里字体名也要注意Windows 自带“黑体”对应的英文名是 simheiLinux 上若找不到这个字体名需要把第一个参数占位改成pygame.font.get_default_font()。这是很多人在 Linux 上跑样例报错font not found的原因。跑通冒烟测试后你的开发环境就具备了写完整游戏的全部条件。接下来要把贪吃蛇拆成几个独立模块不要上来就写一个 500 行的大文件后面排错会非常痛苦。3. 把贪吃蛇拆成四块网格、蛇身、食物与移动逻辑3.1 用固定网格代替像素坐标让碰撞检测变简单贪吃蛇最容易犯的方向性错误是“用像素坐标做碰撞”。像素坐标下的蛇身每个点都是自由浮动的蛇头撞到身体某一段的判定要遍历所有像素点而蛇身每帧还在移动误差和计算量都失控。正确的做法是先把屏幕划分成固定网格蛇的每一节都只落在整数网格点上移动就是坐标加减 1碰撞检测就是元组相等判断。下面这段是网格参数与游戏常量的定义我习惯单独放一个config.py# config.py # 网格逻辑尺寸20x20意味着游戏区最多有 400 个格子 GRID_WIDTH 20 GRID_HEIGHT 20 # 每个格子渲染成 30x30 像素方块窗口大小就是 600x600 CELL_SIZE 30 # 每秒移动多少格数值越大蛇跑得越快 BASE_SPEED 8 # 方向常量方便后续比较 UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0)这里把CELL_SIZE定为 30 是综合考虑后的选择。太小的格子比如 10 像素食物画出来很难看清太大比如 60 像素则窗口要开满屏才能容纳 20 列。更重要的是窗口宽度GRID_WIDTH * CELL_SIZE恰好是 600这个尺寸在大多数笔记本屏幕上完整显示不需要滚动条答辩现场投屏也不会被截断。网格宽高设定 20x20 的好处是蛇身最长可以到 400 节整局游戏玩到后期复杂度依然在可控范围。网格化设计带来的第二个好处是把“蛇头撞墙”的判定从像素边界判断简化为索引越界判断。我一般用一句话说明规则注意网格坐标 (x, y) 中x 表示第几列y 表示第几行。画图时 x 对应屏幕横向y 对应屏幕纵向。后面所有代码都遵循这个约定避免渲染时方向颠倒。3.2 蛇的数据结构用双端队列存蛇身移动时头进尾出蛇的移动本质是“头前进一步尾缩回一格”整体看起来像整条蛇往前平移。做这个逻辑Python 原生的 list 也能实现但 list 在头部插入的时间复杂度是 O(n)蛇身一长每帧都要复制整个列表游戏就会掉帧。更合适的数据结构是collections.deque它从两端增删元素都是 O(1)而且维护一个 deque 就能同时完成“头进尾出”两个操作。# snake.py from collections import deque from config import UP, DOWN, LEFT, RIGHT class Snake: def __init__(self): # 蛇身顺序deque[0] 是蛇头deque[-1] 是蛇尾 # 初始位置放在网格中央偏右长度为 3方向向左不碰墙 self.body deque([(12, 10), (11, 10), (10, 10)]) self.direction RIGHT def head(self): return self.body[0] def move(self): # 关键步骤一弹出旧尾巴 self.body.pop() # 关键步骤二计算新蛇头坐标 x, y self.head() dx, dy self.direction new_head (x dx, y dy) # 关键步骤三把新头插到队首 self.body.appendleft(new_head) def grow(self): # 吃到食物时先复制当前的尾巴再执行普通移动 # 因为 move 会弹掉旧尾巴grow 里先手动补回一个尾部节点 tail self.body[-1] self.move() self.body.append(tail) def hit_self(self): # 蛇头坐标如果在 body 里出现不止一次说明撞到自己 head self.head() return head in list(self.body)[1:]这段代码里move和grow的配合是最容易写错的地方。如果你在grow里先调move再追加尾巴看起来长度只加了 1但追加的坐标未必是正确的延续方向。正确思路是grow的任务是先让蛇正常走一格再把刚才被pop掉的旧尾巴补回来这样总长度净增 1视觉上就是“尾巴后面多了一截”。很多翻车现场是直接把旧尾巴 append 到队尾导致蛇身凭空长出凸起每次吃食物后蛇的形状都畸变。hit_self里的list(self.body)[1:]每次碰撞检测都要做一次转换因为deque不支持切片下标操作而碰撞检测只在移动后执行一次O(n) 的代价在 400 格上限内可以忽略。如果你想更快可以在move里维护一个set同步存蛇身坐标但毕业设计阶段不必做这个优化加了反而增加两个容器之间的一致性维护成本。3.3 食物生成避开蛇身坐标的随机算法食物生成的朴素写法是random.randint(0, GRID_WIDTH - 1)生成 x 和 y然后检查是否落在蛇身上如果落上就重新生成。问题是“重新生成”怎么写很多人会写成固定次数的 for 循环比如重试 10 次还失败就随便放一个坐标结果后期蛇身很长时食物大概率生成在蛇身上游戏行为变得诡异。正确的写法是无限重试直到生成一个有效坐标。400 格的棋盘里蛇身能占满大半个场地的概率极低无限重试在事实上不会死循环# food.py import random from config import GRID_WIDTH, GRID_HEIGHT class Food: def __init__(self): self.position None def spawn(self, snake_body): # 把蛇身坐标转成 set 集合in 判断 O(1) occ set(snake_body) while True: x random.randrange(GRID_WIDTH) y random.randrange(GRID_HEIGHT) if (x, y) not in occ: self.position (x, y) returnrandom.randrange(GRID_WIDTH)和random.randint(0, GRID_WIDTH - 1)等价但语义更直白。坐标转成 set 是关键如果直接用(x, y) in snake_bodydeque 的成员查找是 O(n) 的随机重试的碰撞检查会随蛇身变长越拖越慢。把蛇身坐标一次性转成 set 后每次判断都是 O(1)这个细节就是蛇长到 200 节以后游戏流畅度的分水岭。食物生成还要注意一个体验细节不要把食物生成在蛇头正前方紧邻的一格。因为蛇每帧至少移动一格食物在头上脸生成玩家还没反应蛇头就压过了食物视觉上食物“瞬移”了。处理方式是在spawn里额外排除蛇头方向相邻坐标但毕设论文里也可以不做把它写在“已知缺陷与改进”章节里反而显得你有边界意识。4. 游戏主循环与事件处理单线程循环怎么做到实时响应4.1 主循环骨架时钟、事件、更新、渲染pygame 的游戏本质是一个死循环每轮循环做四件事处理用户输入事件、更新游戏状态、重绘画面、控制帧率。初学者最容易犯的错是把事件处理写在循环外面或者用time.sleep控制速度这两者都会让游戏窗口“假死”。正确的主循环骨架# main.py import pygame from config import GRID_WIDTH, GRID_HEIGHT, CELL_SIZE, BASE_SPEED from snake import Snake from food import Food pygame.init() screen pygame.display.set_mode((GRID_WIDTH * CELL_SIZE, GRID_HEIGHT * CELL_SIZE)) pygame.display.set_caption(贪吃蛇) clock pygame.time.Clock() snake Snake() food Food() food.spawn(snake.body) running True while running: # 第一步把这一帧产生的所有事件取出来处理 for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.KEYDOWN: if event.key pygame.K_UP and snake.direction ! DOWN: snake.direction UP elif event.key pygame.K_DOWN and snake.direction ! UP: snake.direction DOWN elif event.key pygame.K_LEFT and snake.direction ! RIGHT: snake.direction LEFT elif event.key pygame.K_RIGHT and snake.direction ! LEFT: snake.direction RIGHT # 第二步更新状态 snake.move() # 第三步判断迟到食物 if snake.head() food.position: snake.grow() food.spawn(snake.body) # 第四步判断死亡条件 if snake.hit_self(): running False # 第五步画背景、蛇、食物 screen.fill((24, 24, 24)) for x, y in snake.body: pygame.draw.rect( screen, (0, 200, 0), (x * CELL_SIZE, y * CELL_SIZE, CELL_SIZE, CELL_SIZE) ) fx, fy food.position pygame.draw.rect( screen, (200, 0, 0), (fx * CELL_SIZE, fy * CELL_SIZE, CELL_SIZE, CELL_SIZE) ) pygame.display.flip() # 第六步控制帧率也就是蛇的速度 clock.tick(BASE_SPEED) pygame.quit()循环里最容易被忽略的是事件处理的“排队”特性。pygame.event.get()拿到的是一瞬间缓冲的事件列表如果你在循环里加time.sleep(0.1)sleep 期间产生按键事件不会消失而是堆积在缓冲区等 sleep 结束一次性全挤出来表现就是玩家按了一下是因为之前按键队列太长。所以速度控制必须交给clock.tick(BASE_SPEED)它会在每帧末尽量保持帧间隔为1000 / BASE_SPEED毫秒既不占用 CPU也不会吞事件。4.2 方向输入防翻车四方向限制与按键队列主循环里对方向键的处理藏着贪吃蛇最经典的崩溃场景快速连按两下方向键比如蛇向右移动时玩家按了上再按左程序先接收“向上”再接收“向左”可此时蛇头还没完成第二次转向向左直接变成“回头咬自己”。这被称为 180 度掉头问题。解决要在两个层面同时做。第一层是当前帧的方向判断代码里已经写了snake.direction ! DOWN这类反向排除。但注意这个判断只能挡”与当前相反”的方向挡不住“蛇还没转向就再次转向”的连击。第二层是增加一个“方向缓冲区”把一轮帧里产生的按键方向存进队列每帧只消费一个方向# 在主循环外初始化 direction_queue [] # 事件处理里改成入队 elif event.key pygame.K_UP: direction_queue.append(UP) elif event.key pygame.K_DOWN: direction_queue.append(DOWN) # 状态更新前从队列里取一个方向 if direction_queue: new_dir direction_queue.pop(0) if (new_dir[0] snake.direction[0], new_dir[1] snake.direction[1]) ! (0, 0): snake.direction new_dir队列长度超过 2 时可以把队首之外的元素清掉因为玩家在一瞬间内按出的第三个方向基本是误触不需要为了它额外“加速转向”。这是很多游戏手柄输入里默认的一个经验值你可以在报告里写“通过限制方向缓冲队列长度为 2兼顾了响应速度与防误触”。4.3 得分与游戏结算显示、速度提升、重开逻辑一个能交差的贪吃蛇不能只有蛇和食物得有分数显示、死亡提示和重新开始的入口。分数直接用一个整数变量累加每次吃到食物加 10这是最常见也最保守的方案也有按蛇身长度算分的但答辩时会多一个“为什么长度即分数”的解释成本没必要。速度提升逻辑是毕设里容易出彩的点。很多人写的是“每吃一个食物就加快 1 帧”结果蛇到后期快到没法玩。更合理的设计是按分段提速每吃 5 个食物BASE_SPEED增加 1最高封顶 20。这个参数可以做成常量放在配置里# 主循环状态更新部分 if snake.head() food.position: snake.grow() score 10 eat_count 1 if eat_count % 5 0 and BASE_SPEED 20: speed 1重开逻辑的常见做法是在游戏结束后显示Game Over, 按 R 重新开始。实现时不要用recursion递归重启主循环那会爆栈。正确方式是加一个game_over标志位把主循环整体包进while not game_over的嵌套结构或者用running状态机分成 PLAYING / DEAD / RESTART 三种状态。最简单的写法是把整个主循环放进一个while True的大循环内部while running跑单局死亡后跳出内层循环并在外层等待按键。5. 贪吃蛇常见问题与避坑代码能跑不代表交得出5.1 蛇本身是怎么回事现象蛇前进一格后身体从中间断开或者蛇头走了但整条蛇拉伸成一条连续长条看起来不像 3 节而像一整块。原因move()里先appendleft新头再pop旧尾顺序搞反了。若先插头再弹尾尾部弹出的其实是旧蛇头后的第二节蛇身长度不变但形状错位。如果忘了弹尾蛇每帧都在变长视觉上就是不断拉伸。本质是“弹出旧尾必须在插入新头之前”。解决参照 3.2 的代码严格先pop()再appendleft()。排查时不要看渲染直接打印snake.body的坐标内容对照上一步坐标变化一眼就能定位是pop丢了还是appendleft多了。5.2 食物生成在蛇身上游戏开局就死循环现象程序运行后窗口黑屏CPU 占用率拉满甚至 cmd 窗口无报错但卡死。原因random.randint的取值上限写成GRID_WIDTH随机坐标可能出现x20或y20超出了网格索引范围。还有一种可能是spawn里判断蛇身用的是snake.body退化后的坐标但蛇身更新后又把食物覆盖了食物和蛇头重叠主循环里snake.head() food.position永远成立每帧都在“吃食物”。解决第一步把生成坐标的打印放进去看取值范围。第二步在spawn里打印蛇身 set 的大小确认坐标空间确实还有空位。注意蛇身长度等于GRID_WIDTH * GRID_HEIGHT时无限重试会变成真死循环需要在spawn入口加一层判断若蛇长已达上线直接判定胜利退出。5.3 按键方向失灵快速转向不响应现象蛇向右走快速按“上左”蛇没有向左掉头而是继续向右或者直接反向撞到自己。原因事件处理里方向判断的本质是“过滤掉非法反向”但对“还没执行的转向”没有缓冲。加上方向队列后还要注意队列里的新方向是否与队列末尾的方向相反。比如队列里先有 UP再收到 DOWN从蛇的视角看这两个方向抵消了正确的处理是弹出两个方向保持原方向前进而不是执行 180 度反转。解决在入队时检查new_dir与队列末尾方向是否形成反向冲突若冲突则直接丢弃新的方向。这个逻辑写过一次后整个方向系统就稳定了。答辩时这段可以当成“输入防抖”的亮点讲。5.4 报告里贴代码的边界别把整份源码贴进论文现象毕业设计报告查重率爆表或者答辩老师说“源码里面没有注释你是从开源项目抄的吗”。原因很多学生下载开源的贪吃蛇项目把 main.py 原封不动贴进报告连变量命名风格都不一样。技术答辩时老师问“为什么用 deque 不用 list”或“食物生成为何用 while True”答不上来。解决报告里只贴三类代码——核心数据结构定义Snake 类、主循环骨架、碰撞检测函数。每段代码下面写“设计理由”和“性能说明”讲清楚 O(1) vs O(n) 的取舍。把完整的运行代码放附录并注明设计思路这说明是你自己的改造而非抄粘贴。以我的经验答辩老师更看重“你改过什么”而不是“你写了多少行”能在报告里清晰列出这个版本和参考版本的差异就已经是合格的毕设。6. 进阶玩法与验证从能玩到能答辩6.1 存档与读档把最高分和当前局写到本地想让它从“一个小游戏”变成“一个完成了完整数据闭环的小系统”最轻量的方法是加一个本地存档。用 JSON 比 txt 更方便因为字典结构直接序列化不用自己拼字符串解析。import json, os SAVE_FILE snake_save.json def save_score(best_score): data {best: best_score} with open(SAVE_FILE, w, encodingutf-8) as f: json.dump(data, f, ensure_asciiFalse, indent2) def load_score(): if not os.path.exists(SAVE_FILE): return 0 with open(SAVE_FILE, r, encodingutf-8) as f: data json.load(f) return data.get(best, 0)存档路径不要写死成绝对路径用相对路径依赖运行目录。如果你把项目挪到别的机器相对路径下的snake_save.json仍然正常。在main.py里每局结束把score和best比较后写盘这个动作是很好的“数据落盘”练习也是答辩时最容易演示的功能。最后展示时先跑一局关掉程序再重新打开让裁判看到最高分被保留比任何 PPT 截图都有说服力。6.2 让答辩更有料记录每局步数与存活时长最高分之外我更建议加两个统计维度的埋点本局步数和游戏时长。步数在每次snake.move()后累加时长用pygame.time.get_ticks()记录开局时刻结束时取差值换算为秒。把它们写进结束画面的文字里构成“本局步数 / 本局用时 / 历史最高分”三行信息。这三个指标在答辩时能撑起一组有意义的提问步数与长度对应游戏节奏快慢时长与速度提升对应难度曲线设计。你可以把“每吃 5 个食物提速一次”设计成因变量记录步数和时长作为验证数据。如果坚持用手动测试 3 局收集到的数据点足以绘制最简单的难度曲线表而不必编造数字。我这几年带毕设最深的感受是很多学生把时间花在调参美化上忽略了对游戏自身的结构拆解。一个能在报告里画出“状态循环图 数据结构图 事件响应顺序图”的贪吃蛇比一个画了炫酷背景但没有文档的项目好答辩十倍。哪怕你最终只用了本文里六七成的代码也务必把网格坐标、deque 选型理由、方向防抖这三个设计点吃透。代码可以调试思路不行就只能翻车重来。贪吃蛇虽小但一套完整的小型应用该有的部件它都有把它讲清楚你写下一款游戏或工具的底气就有了。希望帮到你。本文还有配套的精品资源点击获取