从决定自学 Python 到写出第一款能正常运行、能得分、能失败重来的小游戏这段过程没有想象中那么难但也没有“刷完教程就能直接上手”那么轻松。很多自学者应该都有类似的感受语法知识点看了不少列表、字典、循环、函数都认识可真到打开编辑器准备写点东西的时候脑子里一片空白。我自己的解决办法很直接——不再继续往下看视频而是找一个稍微有点意思的小项目边写边查资料。这篇就完整记录我用 Python 做贪吃蛇小游戏的全过程包括环境搭建、游戏设计思路、完整可运行的代码和一批调试经验希望给同样处于 Python 入门阶段的朋友做一个参考。文章内容主要围绕几个问题展开自学 Python 该做什么练手项目pygame 怎么安装和使用贪吃蛇这类小游戏的核心逻辑是什么遇到常见报错怎么排查如果你正准备找一个 Python 小游戏项目练手可以直接把这篇文章当作配套教程跟着从头到尾实现一遍。1. 为什么第一个项目选择贪吃蛇小游戏1.1 练手项目怎么选自学 Python 的过程中练手项目的选择会直接影响学习效果的持续性。太简单的项目比如打印九九乘法表做完之后只是把print用得更熟练了一点太复杂的项目比如做一个完整的 Web 系统知识点跨度太大很容易在中间某个环节失去耐心。比较合适的标准有三个功能完整有清晰的输入、处理和输出。单文件或少量文件就能完成不依赖复杂的工程结构。涉及的知识点正好覆盖当前阶段的核心语法。贪吃蛇在这三个方面都很合适。它需要用户输入按键、持续处理移动逻辑、不断输出界面变化并且包含循环、列表、条件判断、函数、随机数、事件响应等 Python 基础语法。做完之后你会发现自己对列表和循环的理解明显比看教程更扎实。1.2 贪吃蛇覆盖了哪些 Python 知识点从学习角度看贪吃蛇项目把 Python 基础语法中的核心部分都串起来了列表的增删和访问。蛇身本质就是坐标点组成的列表蛇移动相当于在列表头部插入新坐标、在尾部删除旧坐标。条件判断。方向控制、碰撞检测、食物判定都是由一系列if条件组成的。while循环。游戏的主循环负责不停检测输入、更新状态、刷新画面这是游戏开发的核心模式。函数与模块化。把绘制、食物生成、分数显示拆成独立函数代码才能保持清晰。事件驱动。pygame 通过事件队列处理键盘输入这也是很多图形界面程序的通用思路。可以说一个贪吃蛇小游戏写下来Python 入门阶段的核心语法基本上都实战了一遍。这种“用项目带语法”的学习方式比单纯刷教程更容易留下印象。1.3 最终实现的效果这个贪吃蛇小游戏具备以下几项功能使用方向键控制蛇头上下左右移动。蛇吃到随机出现的食物后长度增加 1分数增加 1。蛇撞到墙壁或者撞到自己的身体游戏结束。移动过程中禁止直接反向移动避免蛇头瞬间撞到自己。整个项目只有一个 Python 文件运行方式很简单。对新手来说它既有观赏性又有足够的逻辑复杂度是 Python 入门阶段性价比很高的一个实践项目。2. 环境准备与版本说明2.1 安装 Python开始写代码之前需要先确认电脑上的 Python 环境。Python 安装过程本身不难但有两个容易踩坑的地方一是忘记勾选“Add Python to PATH”导致命令行里无法运行python命令二是电脑上存在多个 Python 版本导致pip装包时装到了别的环境。如果还没安装 Python建议去官网下载对应操作系统的安装包。安装过程中记得勾选 Add Python to PATH安装完成后打开终端输入python --version能正常输出版本号说明环境没问题。需要说明的是不同操作系统和 Python 版本之间可能存在差异本文示例以 Python 3 系列常见稳定版本为例重点演示实现思路。如果执行命令提示找不到 Python可以尝试改用python3命令。2.2 安装 pygame贪吃蛇需要图形界面这里选择 pygame。pygame 是 Python 生态里非常常用的 2D 游戏开发库内部封装了窗口创建、事件处理、图形绘制、声音播放等底层能力非常适合用来做各类 Python 小游戏。安装命令pip install pygame如果你使用的是国内网络可以指定镜像源加速pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后在 Python 交互环境里验证import pygame print(pygame.version.ver)能输出 pygame 版本号说明安装成功。这里补充一个建议如果电脑上同时存在多个 Python 版本或者准备在不同项目中使用不同版本的依赖库尽量在虚拟环境中开发。虚拟环境可以把当前项目的依赖隔离起来避免全局环境越来越乱。创建和使用虚拟环境的基本命令是python -m venv venv激活虚拟环境后再执行pip install pygame这样安装的库就只属于当前项目。虽然是入门项目但建立使用虚拟环境的习惯对后续深入 Python 开发很有帮助。2.3 项目目录结构为了让思路更清楚项目目录保持简单snake-game/ └── snake_game.py整个游戏就在一个 Python 文件里实现。这样做的好处是方便直接运行、方便阅读对于入门项目来说足够清晰。后续想扩展的时候再根据功能拆分模块。3. 游戏设计先想清楚再写代码很多新手写代码时习惯直接动手写到一半发现逻辑乱了又推倒重来。贪吃蛇这个项目规模不大但写之前把设计想清楚能省下大量调试时间。3.1 游戏规则贪吃蛇的基本规则可以归纳为四条蛇在一个固定大小的矩形区域里移动。玩家通过方向键控制蛇头方向。蛇头碰到食物时食物消失蛇身长度增加分数增加。蛇头碰到墙壁或碰到自身身体时游戏结束。这里需要注意“反向移动”规则。如果蛇当前向右移动玩家立即按左键蛇头就会直接撞到自己的身体。实现时要做限制比较常见的做法是不允许蛇头朝当前移动方向的反方向走。这个细节虽然小但如果没有处理好会出现一按反方向键就立刻判定游戏结束的问题体验很差。3.2 坐标与游戏界面游戏界面本质上是一个平面坐标系。我们需要把窗口分成固定大小的格子蛇头和食物都落在某个格子上。本文示例的窗口大小为 600 × 600每个格子大小为 20 × 20因此横向和纵向各有 30 个格子。蛇身用一组格子坐标表示例如(5, 5)表示第 5 列第 5 行的格子。采用格子坐标而不是直接使用像素坐标有一个明显好处碰撞检测和蛇身增长都只需要处理整数坐标逻辑更简单。绘制的时候再把格子坐标换算成像素坐标既保持了游戏逻辑的清晰又能方便调整窗口或格子大小。3.3 数据模型设计整个游戏只需要保存三类核心数据蛇一个列表列表每一项是一个(x, y)坐标元组列表头部是蛇头尾部是蛇尾。方向一个元组例如(1, 0)表示向右(0, -1)表示向上。食物一个坐标元组表示食物所在的格子。蛇移动的过程本质上就是两步操作第一步根据当前方向计算出新蛇头坐标插入列表头部。第二步如果没有吃到食物就从列表尾部删除一个坐标。如果吃到了食物就不删除尾部坐标蛇身长度自然增加。这也是贪吃蛇最核心的一段逻辑理解了这两步整个游戏的主干就理解了。4. 逐步实现游戏核心代码下面进入代码实现环节。为了让代码可读性更好我会从拆解每个功能开始最后再给出完整代码。4.1 创建游戏窗口pygame 的使用有几个固定的初始化步骤。先导入库然后调用pygame.init()初始化所有模块再用pygame.display.set_mode创建窗口。# 文件路径snake_game.py import pygame import random import sys # 初始化 pygame pygame.init() # 颜色RGB 格式 BLACK (0, 0, 0) WHITE (255, 255, 255) GREEN (0, 200, 0) RED (200, 0, 0) # 窗口尺寸 WINDOW_WIDTH 600 WINDOW_HEIGHT 600 # 格子大小 BLOCK_SIZE 20 # 创建窗口并设置标题 screen pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption(贪吃蛇小游戏) # 创建时钟对象用于控制游戏帧率 clock pygame.time.Clock()这段代码有几个地方值得注意。pygame.init()是使用 pygame 前必须执行的一次性初始化。颜色用 RGB 元组表示每种颜色的数值范围是 0 到 255。后面会用到clock.tick()它控制游戏循环的刷新频率数字越大游戏运行速度越快。4.2 绘制蛇与食物游戏中需要反复绘制蛇身和食物因此把绘制逻辑封装成函数是更清晰的做法。def draw_block(pos, color): 在指定格子位置绘制一个色块 rect pygame.Rect( pos[0] * BLOCK_SIZE, pos[1] * BLOCK_SIZE, BLOCK_SIZE, BLOCK_SIZE ) pygame.draw.rect(screen, color, rect)draw_block接收一个格子坐标和一个颜色内部通过乘法把格子坐标转换成像素坐标。比如格子坐标(3, 5)在 20 × 20 的格子下对应像素坐标是(60, 100)。食物的生成要保证不出现在蛇身上。用random.randint随机生成坐标然后判断这个坐标是否在蛇身列表里如果在就重新生成def generate_food(snake): 随机生成一个不在蛇身上的食物坐标 while True: x random.randint(0, WINDOW_WIDTH // BLOCK_SIZE - 1) y random.randint(0, WINDOW_HEIGHT // BLOCK_SIZE - 1) if (x, y) not in snake: return (x, y)注意这里使用了WINDOW_WIDTH // BLOCK_SIZE - 1作为随机范围的上限。因为窗口宽度 600 除以格子大小 20 得到 30坐标范围应该是 0 到 29所以必须减 1否则食物可能生成在窗口边界之外。4.3 蛇的移动与按键控制接下来是游戏主循环。pygame 程序的核心是“事件循环”不断检查有没有窗口关闭事件、有没有按键按下事件然后根据事件更新游戏状态。UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0) # 蛇的初始状态 snake [(5, 5), (4, 5), (3, 5)] direction RIGHT food generate_food(snake) score 0 while True: for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() if event.type pygame.KEYDOWN: if event.key pygame.K_UP and direction ! DOWN: direction UP elif event.key pygame.K_DOWN and direction ! UP: direction DOWN elif event.key pygame.K_LEFT and direction ! RIGHT: direction LEFT elif event.key pygame.K_RIGHT and direction ! LEFT: direction RIGHT方向控制的关键在于限制反向。以向上为例如果当前方向本身就是向下就不能改为向上否则蛇头会立刻撞到身体。direction ! DOWN这个条件做的就是这件事。pygame.QUIT事件对应窗口右上角的关闭按钮收到之后调用pygame.quit()和sys.exit()退出程序。这是 pygame 程序必不可少的收尾逻辑。4.4 碰撞检测与计分每帧游戏循环中先根据当前方向算出新蛇头坐标然后做两类碰撞检测撞墙检测和撞自己检测。如果没有碰撞再决定蛇是否增长。# 计算新蛇头坐标 head_x, head_y snake[0] new_head (head_x direction[0], head_y direction[1]) # 撞墙检测 grid_width WINDOW_WIDTH // BLOCK_SIZE grid_height WINDOW_HEIGHT // BLOCK_SIZE if new_head[0] 0 or new_head[0] grid_width: print(游戏结束撞到墙壁) break if new_head[1] 0 or new_head[1] grid_height: print(游戏结束撞到墙壁) break # 撞自己检测 if new_head in snake: print(游戏结束撞到自己) break # 蛇头移动到新位置 snake.insert(0, new_head) if new_head food: score 1 food generate_food(snake) else: snake.pop()这里的逻辑顺序很关键先判断新蛇头是否合法再移动蛇身最后判断是否吃到食物。如果顺序颠倒蛇头已经插入列表再判断碰撞就容易出现判断错误。撞墙或撞自己时用break跳出循环随后程序结束。为了让玩家看清结束原因退出前在终端输出了一句提示。后面可以进一步优化改成在游戏窗口里显示结束画面。4.5 完整可运行代码把上面的部分组合起来就是一个完整可运行的贪吃蛇小游戏# 文件路径snake_game.py import pygame import random import sys pygame.init() BLACK (0, 0, 0) WHITE (255, 255, 255) GREEN (0, 200, 0) RED (200, 0, 0) WINDOW_WIDTH 600 WINDOW_HEIGHT 600 BLOCK_SIZE 20 screen pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption(贪吃蛇小游戏) clock pygame.time.Clock() UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0) def draw_block(pos, color): 在指定格子位置绘制一个色块 rect pygame.Rect( pos[0] * BLOCK_SIZE, pos[1] * BLOCK_SIZE, BLOCK_SIZE, BLOCK_SIZE ) pygame.draw.rect(screen, color, rect) def generate_food(snake): 随机生成一个不在蛇身上的食物坐标 while True: x random.randint(0, WINDOW_WIDTH // BLOCK_SIZE - 1) y random.randint(0, WINDOW_HEIGHT // BLOCK_SIZE - 1) if (x, y) not in snake: return (x, y) def show_score(score): 在窗口左上角显示当前分数 font pygame.font.Font(None, 36) text font.render(f得分: {score}, True, WHITE) screen.blit(text, (10, 10)) def main(): snake [(5, 5), (4, 5), (3, 5)] direction RIGHT food generate_food(snake) score 0 while True: for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() if event.type pygame.KEYDOWN: if event.key pygame.K_UP and direction ! DOWN: direction UP elif event.key pygame.K_DOWN and direction ! UP: direction DOWN elif event.key pygame.K_LEFT and direction ! RIGHT: direction LEFT elif event.key pygame.K_RIGHT and direction ! LEFT: direction RIGHT head_x, head_y snake[0] new_head (head_x direction[0], head_y direction[1]) grid_width WINDOW_WIDTH // BLOCK_SIZE grid_height WINDOW_HEIGHT // BLOCK_SIZE if new_head[0] 0 or new_head[0] grid_width: print(游戏结束撞到墙壁) break if new_head[1] 0 or new_head[1] grid_height: print(游戏结束撞到墙壁) break if new_head in snake: print(游戏结束撞到自己) break snake.insert(0, new_head) if new_head food: score 1 food generate_food(snake) else: snake.pop() screen.fill(BLACK) for body in snake: draw_block(body, GREEN) draw_block(food, RED) show_score(score) pygame.display.update() clock.tick(10) if __name__ __main__: main()5. 运行与验证5.1 启动游戏在snake_game.py所在目录打开终端执行python snake_game.py如果环境配置正确会弹出一个 600 × 600 的黑色窗口窗口左上角显示“得分: 0”窗口中间出现一条三节的绿色蛇和一个红色食物。5.2 预期运行效果按上下左右方向键蛇会朝对应方向移动。蛇吃到红色食物后食物消失并在新位置出现分数加 1蛇身长度增加。蛇撞到窗口边缘或蛇头与蛇身重合时程序在终端打印提示并结束。直接按反方向键时方向不会改变避免蛇立刻撞到自己。5.3 如何调整难度游戏速度由clock.tick(10)控制数值越大蛇移动越快。刚运行时可能觉得速度偏慢这是故意设置的。新手可以先在低速下观察移动和碰撞逻辑熟悉之后再逐步提高到 15、20 甚至更高。调整一个数字就能改变游戏难度这也是把参数集中写在代码里带来的好处。6. 常见问题与排查思路问题现象常见原因解决思路ModuleNotFoundError: No module named pygamepygame 未安装或安装到了另一个 Python 环境重新执行pip install pygame确认安装到当前解释器环境python命令无法识别安装 Python 时未勾选 Add Python to PATH重新安装并勾选或手动配置 PATH 环境变量游戏窗口一闪就关闭代码运行异常或窗口创建失败在终端中运行程序查看完整报错堆栈按方向键没反应按键被反向移动限制拦截检查direction ! DOWN这类限制条件是否正确食物生成在窗口外随机范围上限没有减 1使用WINDOW_WIDTH // BLOCK_SIZE - 1作为randint上限蛇移动太快或太慢clock.tick()数值不合适调整数值游戏循环刷新频率越高蛇移动越快pip 安装速度慢或超时网络原因导致下载不稳定使用国内镜像源安装例如清华 PyPI 镜像遇到报错时建议先完整读一遍终端里的错误信息。很多初学者看到红色报错就紧张其实 Python 的报错信息已经写明了问题文件和行号按提示去检查对应代码大部分问题都能自己解决。7. 最佳实践与优化建议写完能运行的代码只是第一步。如果想让这个 Python 小游戏项目更规范、更容易扩展可以从几个方向继续优化。7.1 把参数抽成配置常量现在窗口尺寸、格子大小、移动速度、颜色都分散在代码中。更好的做法是集中在文件头部定义例如所有颜色放在一起、所有尺寸放在一起、所有难度参数放在一起。以后想改成浅色主题、更大的窗口、更快的初始速度只需要改几个常量不用在代码里到处搜索。7.2 增加游戏结束画面目前游戏结束后直接退出显得有点生硬。可以改成在窗口中央显示“游戏结束”和最终得分并提示按任意键退出。这会用到 pygame 的字体渲染和延时处理难度不高但能明显提升游戏体验。7.3 增加暂停与重新开始功能对于完整的小游戏来说暂停功能几乎是必备的。可以用空格键控制暂停状态在游戏循环里通过一个布尔变量is_paused控制逻辑是否更新。重新开始功能则需要把蛇、方向、分数、食物全部重置为初始值。这两个功能用到的知识点还是变量、条件判断和事件处理适合作为第一个扩展练习。7.4 用面向对象重构当需求变复杂时可以考虑用面向对象的方式重构。把蛇、食物、游戏状态都设计成类每个类负责自己的属性和行为。比如Snake类可以管理身体列表、移动方法和方向控制Food类负责生成和位置判断。这个练习很适合巩固 Python 的类、对象、方法等概念也是从“会写脚本”向“会设计程序”过渡的关键一步。7.5 代码结构拆分与 Git 管理如果继续增加功能单个文件会越来越长。这时候可以按功能拆模块例如snake.py负责蛇的逻辑food.py负责食物生成game.py负责主循环和事件处理。同时建议给项目建一个 Git 仓库即使暂时不打算开源本地管理版本也能让你随时回溯代码改到一半发现方向错了可以轻松回退。8. 下一步学习方向贪吃蛇做完之后可以先花点时间复盘。例如哪些知识点原本就会哪些是写项目时边查边学会的哪些地方花的时间最多。花时间最多的地方往往就是你的薄弱点记录下来后续针对性加强。接下来可以尝试的方向很多。比如给贪吃蛇增加障碍物和关卡理解“游戏状态”如何随关卡切换或者做一个打砖块、飞机大战类的小游戏熟悉 pygame 的图片加载、音效和碰撞特效也可以尝试用面向对象重写这个贪吃蛇把逻辑按类拆分锻炼代码设计能力甚至可以把最高分保存到文件或数据库顺便练习文件读写和简单数据持久化。如果后续打算往后端开发方向走可以继续夯实 Python 基础、数据结构、文件操作、异常处理再过渡到 Web 框架。游戏项目积累的是对代码运行流程和调试能力的理解这些能力到任何技术方向都通用。自学 Python 最怕的不是遇到报错而是停留在“看得懂”的舒适区。把一个小的 Python 小游戏亲手写出来、跑起来再改出问题并解决掉这个过程收获很大。如果你也处在 Python 入门阶段建议打开编辑器照着完整代码敲一遍然后试着改几个参数观察效果变化。下一次再遇到类似的项目你就知道该从哪里下手了。
从决定自学 Python 到写出第一款能正常运行、能得分、能失败重来的小游戏这段过程没有想象中那么难但也没有“刷完教程就能直接上手”那么轻松。很多自学者应该都有类似的感受语法知识点看了不少列表、字典、循环、函数都认识可真到打开编辑器准备写点东西的时候脑子里一片空白。我自己的解决办法很直接——不再继续往下看视频而是找一个稍微有点意思的小项目边写边查资料。这篇就完整记录我用 Python 做贪吃蛇小游戏的全过程包括环境搭建、游戏设计思路、完整可运行的代码和一批调试经验希望给同样处于 Python 入门阶段的朋友做一个参考。文章内容主要围绕几个问题展开自学 Python 该做什么练手项目pygame 怎么安装和使用贪吃蛇这类小游戏的核心逻辑是什么遇到常见报错怎么排查如果你正准备找一个 Python 小游戏项目练手可以直接把这篇文章当作配套教程跟着从头到尾实现一遍。1. 为什么第一个项目选择贪吃蛇小游戏1.1 练手项目怎么选自学 Python 的过程中练手项目的选择会直接影响学习效果的持续性。太简单的项目比如打印九九乘法表做完之后只是把print用得更熟练了一点太复杂的项目比如做一个完整的 Web 系统知识点跨度太大很容易在中间某个环节失去耐心。比较合适的标准有三个功能完整有清晰的输入、处理和输出。单文件或少量文件就能完成不依赖复杂的工程结构。涉及的知识点正好覆盖当前阶段的核心语法。贪吃蛇在这三个方面都很合适。它需要用户输入按键、持续处理移动逻辑、不断输出界面变化并且包含循环、列表、条件判断、函数、随机数、事件响应等 Python 基础语法。做完之后你会发现自己对列表和循环的理解明显比看教程更扎实。1.2 贪吃蛇覆盖了哪些 Python 知识点从学习角度看贪吃蛇项目把 Python 基础语法中的核心部分都串起来了列表的增删和访问。蛇身本质就是坐标点组成的列表蛇移动相当于在列表头部插入新坐标、在尾部删除旧坐标。条件判断。方向控制、碰撞检测、食物判定都是由一系列if条件组成的。while循环。游戏的主循环负责不停检测输入、更新状态、刷新画面这是游戏开发的核心模式。函数与模块化。把绘制、食物生成、分数显示拆成独立函数代码才能保持清晰。事件驱动。pygame 通过事件队列处理键盘输入这也是很多图形界面程序的通用思路。可以说一个贪吃蛇小游戏写下来Python 入门阶段的核心语法基本上都实战了一遍。这种“用项目带语法”的学习方式比单纯刷教程更容易留下印象。1.3 最终实现的效果这个贪吃蛇小游戏具备以下几项功能使用方向键控制蛇头上下左右移动。蛇吃到随机出现的食物后长度增加 1分数增加 1。蛇撞到墙壁或者撞到自己的身体游戏结束。移动过程中禁止直接反向移动避免蛇头瞬间撞到自己。整个项目只有一个 Python 文件运行方式很简单。对新手来说它既有观赏性又有足够的逻辑复杂度是 Python 入门阶段性价比很高的一个实践项目。2. 环境准备与版本说明2.1 安装 Python开始写代码之前需要先确认电脑上的 Python 环境。Python 安装过程本身不难但有两个容易踩坑的地方一是忘记勾选“Add Python to PATH”导致命令行里无法运行python命令二是电脑上存在多个 Python 版本导致pip装包时装到了别的环境。如果还没安装 Python建议去官网下载对应操作系统的安装包。安装过程中记得勾选 Add Python to PATH安装完成后打开终端输入python --version能正常输出版本号说明环境没问题。需要说明的是不同操作系统和 Python 版本之间可能存在差异本文示例以 Python 3 系列常见稳定版本为例重点演示实现思路。如果执行命令提示找不到 Python可以尝试改用python3命令。2.2 安装 pygame贪吃蛇需要图形界面这里选择 pygame。pygame 是 Python 生态里非常常用的 2D 游戏开发库内部封装了窗口创建、事件处理、图形绘制、声音播放等底层能力非常适合用来做各类 Python 小游戏。安装命令pip install pygame如果你使用的是国内网络可以指定镜像源加速pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后在 Python 交互环境里验证import pygame print(pygame.version.ver)能输出 pygame 版本号说明安装成功。这里补充一个建议如果电脑上同时存在多个 Python 版本或者准备在不同项目中使用不同版本的依赖库尽量在虚拟环境中开发。虚拟环境可以把当前项目的依赖隔离起来避免全局环境越来越乱。创建和使用虚拟环境的基本命令是python -m venv venv激活虚拟环境后再执行pip install pygame这样安装的库就只属于当前项目。虽然是入门项目但建立使用虚拟环境的习惯对后续深入 Python 开发很有帮助。2.3 项目目录结构为了让思路更清楚项目目录保持简单snake-game/ └── snake_game.py整个游戏就在一个 Python 文件里实现。这样做的好处是方便直接运行、方便阅读对于入门项目来说足够清晰。后续想扩展的时候再根据功能拆分模块。3. 游戏设计先想清楚再写代码很多新手写代码时习惯直接动手写到一半发现逻辑乱了又推倒重来。贪吃蛇这个项目规模不大但写之前把设计想清楚能省下大量调试时间。3.1 游戏规则贪吃蛇的基本规则可以归纳为四条蛇在一个固定大小的矩形区域里移动。玩家通过方向键控制蛇头方向。蛇头碰到食物时食物消失蛇身长度增加分数增加。蛇头碰到墙壁或碰到自身身体时游戏结束。这里需要注意“反向移动”规则。如果蛇当前向右移动玩家立即按左键蛇头就会直接撞到自己的身体。实现时要做限制比较常见的做法是不允许蛇头朝当前移动方向的反方向走。这个细节虽然小但如果没有处理好会出现一按反方向键就立刻判定游戏结束的问题体验很差。3.2 坐标与游戏界面游戏界面本质上是一个平面坐标系。我们需要把窗口分成固定大小的格子蛇头和食物都落在某个格子上。本文示例的窗口大小为 600 × 600每个格子大小为 20 × 20因此横向和纵向各有 30 个格子。蛇身用一组格子坐标表示例如(5, 5)表示第 5 列第 5 行的格子。采用格子坐标而不是直接使用像素坐标有一个明显好处碰撞检测和蛇身增长都只需要处理整数坐标逻辑更简单。绘制的时候再把格子坐标换算成像素坐标既保持了游戏逻辑的清晰又能方便调整窗口或格子大小。3.3 数据模型设计整个游戏只需要保存三类核心数据蛇一个列表列表每一项是一个(x, y)坐标元组列表头部是蛇头尾部是蛇尾。方向一个元组例如(1, 0)表示向右(0, -1)表示向上。食物一个坐标元组表示食物所在的格子。蛇移动的过程本质上就是两步操作第一步根据当前方向计算出新蛇头坐标插入列表头部。第二步如果没有吃到食物就从列表尾部删除一个坐标。如果吃到了食物就不删除尾部坐标蛇身长度自然增加。这也是贪吃蛇最核心的一段逻辑理解了这两步整个游戏的主干就理解了。4. 逐步实现游戏核心代码下面进入代码实现环节。为了让代码可读性更好我会从拆解每个功能开始最后再给出完整代码。4.1 创建游戏窗口pygame 的使用有几个固定的初始化步骤。先导入库然后调用pygame.init()初始化所有模块再用pygame.display.set_mode创建窗口。# 文件路径snake_game.py import pygame import random import sys # 初始化 pygame pygame.init() # 颜色RGB 格式 BLACK (0, 0, 0) WHITE (255, 255, 255) GREEN (0, 200, 0) RED (200, 0, 0) # 窗口尺寸 WINDOW_WIDTH 600 WINDOW_HEIGHT 600 # 格子大小 BLOCK_SIZE 20 # 创建窗口并设置标题 screen pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption(贪吃蛇小游戏) # 创建时钟对象用于控制游戏帧率 clock pygame.time.Clock()这段代码有几个地方值得注意。pygame.init()是使用 pygame 前必须执行的一次性初始化。颜色用 RGB 元组表示每种颜色的数值范围是 0 到 255。后面会用到clock.tick()它控制游戏循环的刷新频率数字越大游戏运行速度越快。4.2 绘制蛇与食物游戏中需要反复绘制蛇身和食物因此把绘制逻辑封装成函数是更清晰的做法。def draw_block(pos, color): 在指定格子位置绘制一个色块 rect pygame.Rect( pos[0] * BLOCK_SIZE, pos[1] * BLOCK_SIZE, BLOCK_SIZE, BLOCK_SIZE ) pygame.draw.rect(screen, color, rect)draw_block接收一个格子坐标和一个颜色内部通过乘法把格子坐标转换成像素坐标。比如格子坐标(3, 5)在 20 × 20 的格子下对应像素坐标是(60, 100)。食物的生成要保证不出现在蛇身上。用random.randint随机生成坐标然后判断这个坐标是否在蛇身列表里如果在就重新生成def generate_food(snake): 随机生成一个不在蛇身上的食物坐标 while True: x random.randint(0, WINDOW_WIDTH // BLOCK_SIZE - 1) y random.randint(0, WINDOW_HEIGHT // BLOCK_SIZE - 1) if (x, y) not in snake: return (x, y)注意这里使用了WINDOW_WIDTH // BLOCK_SIZE - 1作为随机范围的上限。因为窗口宽度 600 除以格子大小 20 得到 30坐标范围应该是 0 到 29所以必须减 1否则食物可能生成在窗口边界之外。4.3 蛇的移动与按键控制接下来是游戏主循环。pygame 程序的核心是“事件循环”不断检查有没有窗口关闭事件、有没有按键按下事件然后根据事件更新游戏状态。UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0) # 蛇的初始状态 snake [(5, 5), (4, 5), (3, 5)] direction RIGHT food generate_food(snake) score 0 while True: for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() if event.type pygame.KEYDOWN: if event.key pygame.K_UP and direction ! DOWN: direction UP elif event.key pygame.K_DOWN and direction ! UP: direction DOWN elif event.key pygame.K_LEFT and direction ! RIGHT: direction LEFT elif event.key pygame.K_RIGHT and direction ! LEFT: direction RIGHT方向控制的关键在于限制反向。以向上为例如果当前方向本身就是向下就不能改为向上否则蛇头会立刻撞到身体。direction ! DOWN这个条件做的就是这件事。pygame.QUIT事件对应窗口右上角的关闭按钮收到之后调用pygame.quit()和sys.exit()退出程序。这是 pygame 程序必不可少的收尾逻辑。4.4 碰撞检测与计分每帧游戏循环中先根据当前方向算出新蛇头坐标然后做两类碰撞检测撞墙检测和撞自己检测。如果没有碰撞再决定蛇是否增长。# 计算新蛇头坐标 head_x, head_y snake[0] new_head (head_x direction[0], head_y direction[1]) # 撞墙检测 grid_width WINDOW_WIDTH // BLOCK_SIZE grid_height WINDOW_HEIGHT // BLOCK_SIZE if new_head[0] 0 or new_head[0] grid_width: print(游戏结束撞到墙壁) break if new_head[1] 0 or new_head[1] grid_height: print(游戏结束撞到墙壁) break # 撞自己检测 if new_head in snake: print(游戏结束撞到自己) break # 蛇头移动到新位置 snake.insert(0, new_head) if new_head food: score 1 food generate_food(snake) else: snake.pop()这里的逻辑顺序很关键先判断新蛇头是否合法再移动蛇身最后判断是否吃到食物。如果顺序颠倒蛇头已经插入列表再判断碰撞就容易出现判断错误。撞墙或撞自己时用break跳出循环随后程序结束。为了让玩家看清结束原因退出前在终端输出了一句提示。后面可以进一步优化改成在游戏窗口里显示结束画面。4.5 完整可运行代码把上面的部分组合起来就是一个完整可运行的贪吃蛇小游戏# 文件路径snake_game.py import pygame import random import sys pygame.init() BLACK (0, 0, 0) WHITE (255, 255, 255) GREEN (0, 200, 0) RED (200, 0, 0) WINDOW_WIDTH 600 WINDOW_HEIGHT 600 BLOCK_SIZE 20 screen pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption(贪吃蛇小游戏) clock pygame.time.Clock() UP (0, -1) DOWN (0, 1) LEFT (-1, 0) RIGHT (1, 0) def draw_block(pos, color): 在指定格子位置绘制一个色块 rect pygame.Rect( pos[0] * BLOCK_SIZE, pos[1] * BLOCK_SIZE, BLOCK_SIZE, BLOCK_SIZE ) pygame.draw.rect(screen, color, rect) def generate_food(snake): 随机生成一个不在蛇身上的食物坐标 while True: x random.randint(0, WINDOW_WIDTH // BLOCK_SIZE - 1) y random.randint(0, WINDOW_HEIGHT // BLOCK_SIZE - 1) if (x, y) not in snake: return (x, y) def show_score(score): 在窗口左上角显示当前分数 font pygame.font.Font(None, 36) text font.render(f得分: {score}, True, WHITE) screen.blit(text, (10, 10)) def main(): snake [(5, 5), (4, 5), (3, 5)] direction RIGHT food generate_food(snake) score 0 while True: for event in pygame.event.get(): if event.type pygame.QUIT: pygame.quit() sys.exit() if event.type pygame.KEYDOWN: if event.key pygame.K_UP and direction ! DOWN: direction UP elif event.key pygame.K_DOWN and direction ! UP: direction DOWN elif event.key pygame.K_LEFT and direction ! RIGHT: direction LEFT elif event.key pygame.K_RIGHT and direction ! LEFT: direction RIGHT head_x, head_y snake[0] new_head (head_x direction[0], head_y direction[1]) grid_width WINDOW_WIDTH // BLOCK_SIZE grid_height WINDOW_HEIGHT // BLOCK_SIZE if new_head[0] 0 or new_head[0] grid_width: print(游戏结束撞到墙壁) break if new_head[1] 0 or new_head[1] grid_height: print(游戏结束撞到墙壁) break if new_head in snake: print(游戏结束撞到自己) break snake.insert(0, new_head) if new_head food: score 1 food generate_food(snake) else: snake.pop() screen.fill(BLACK) for body in snake: draw_block(body, GREEN) draw_block(food, RED) show_score(score) pygame.display.update() clock.tick(10) if __name__ __main__: main()5. 运行与验证5.1 启动游戏在snake_game.py所在目录打开终端执行python snake_game.py如果环境配置正确会弹出一个 600 × 600 的黑色窗口窗口左上角显示“得分: 0”窗口中间出现一条三节的绿色蛇和一个红色食物。5.2 预期运行效果按上下左右方向键蛇会朝对应方向移动。蛇吃到红色食物后食物消失并在新位置出现分数加 1蛇身长度增加。蛇撞到窗口边缘或蛇头与蛇身重合时程序在终端打印提示并结束。直接按反方向键时方向不会改变避免蛇立刻撞到自己。5.3 如何调整难度游戏速度由clock.tick(10)控制数值越大蛇移动越快。刚运行时可能觉得速度偏慢这是故意设置的。新手可以先在低速下观察移动和碰撞逻辑熟悉之后再逐步提高到 15、20 甚至更高。调整一个数字就能改变游戏难度这也是把参数集中写在代码里带来的好处。6. 常见问题与排查思路问题现象常见原因解决思路ModuleNotFoundError: No module named pygamepygame 未安装或安装到了另一个 Python 环境重新执行pip install pygame确认安装到当前解释器环境python命令无法识别安装 Python 时未勾选 Add Python to PATH重新安装并勾选或手动配置 PATH 环境变量游戏窗口一闪就关闭代码运行异常或窗口创建失败在终端中运行程序查看完整报错堆栈按方向键没反应按键被反向移动限制拦截检查direction ! DOWN这类限制条件是否正确食物生成在窗口外随机范围上限没有减 1使用WINDOW_WIDTH // BLOCK_SIZE - 1作为randint上限蛇移动太快或太慢clock.tick()数值不合适调整数值游戏循环刷新频率越高蛇移动越快pip 安装速度慢或超时网络原因导致下载不稳定使用国内镜像源安装例如清华 PyPI 镜像遇到报错时建议先完整读一遍终端里的错误信息。很多初学者看到红色报错就紧张其实 Python 的报错信息已经写明了问题文件和行号按提示去检查对应代码大部分问题都能自己解决。7. 最佳实践与优化建议写完能运行的代码只是第一步。如果想让这个 Python 小游戏项目更规范、更容易扩展可以从几个方向继续优化。7.1 把参数抽成配置常量现在窗口尺寸、格子大小、移动速度、颜色都分散在代码中。更好的做法是集中在文件头部定义例如所有颜色放在一起、所有尺寸放在一起、所有难度参数放在一起。以后想改成浅色主题、更大的窗口、更快的初始速度只需要改几个常量不用在代码里到处搜索。7.2 增加游戏结束画面目前游戏结束后直接退出显得有点生硬。可以改成在窗口中央显示“游戏结束”和最终得分并提示按任意键退出。这会用到 pygame 的字体渲染和延时处理难度不高但能明显提升游戏体验。7.3 增加暂停与重新开始功能对于完整的小游戏来说暂停功能几乎是必备的。可以用空格键控制暂停状态在游戏循环里通过一个布尔变量is_paused控制逻辑是否更新。重新开始功能则需要把蛇、方向、分数、食物全部重置为初始值。这两个功能用到的知识点还是变量、条件判断和事件处理适合作为第一个扩展练习。7.4 用面向对象重构当需求变复杂时可以考虑用面向对象的方式重构。把蛇、食物、游戏状态都设计成类每个类负责自己的属性和行为。比如Snake类可以管理身体列表、移动方法和方向控制Food类负责生成和位置判断。这个练习很适合巩固 Python 的类、对象、方法等概念也是从“会写脚本”向“会设计程序”过渡的关键一步。7.5 代码结构拆分与 Git 管理如果继续增加功能单个文件会越来越长。这时候可以按功能拆模块例如snake.py负责蛇的逻辑food.py负责食物生成game.py负责主循环和事件处理。同时建议给项目建一个 Git 仓库即使暂时不打算开源本地管理版本也能让你随时回溯代码改到一半发现方向错了可以轻松回退。8. 下一步学习方向贪吃蛇做完之后可以先花点时间复盘。例如哪些知识点原本就会哪些是写项目时边查边学会的哪些地方花的时间最多。花时间最多的地方往往就是你的薄弱点记录下来后续针对性加强。接下来可以尝试的方向很多。比如给贪吃蛇增加障碍物和关卡理解“游戏状态”如何随关卡切换或者做一个打砖块、飞机大战类的小游戏熟悉 pygame 的图片加载、音效和碰撞特效也可以尝试用面向对象重写这个贪吃蛇把逻辑按类拆分锻炼代码设计能力甚至可以把最高分保存到文件或数据库顺便练习文件读写和简单数据持久化。如果后续打算往后端开发方向走可以继续夯实 Python 基础、数据结构、文件操作、异常处理再过渡到 Web 框架。游戏项目积累的是对代码运行流程和调试能力的理解这些能力到任何技术方向都通用。自学 Python 最怕的不是遇到报错而是停留在“看得懂”的舒适区。把一个小的 Python 小游戏亲手写出来、跑起来再改出问题并解决掉这个过程收获很大。如果你也处在 Python 入门阶段建议打开编辑器照着完整代码敲一遍然后试着改几个参数观察效果变化。下一次再遇到类似的项目你就知道该从哪里下手了。
