用Python写一个贪吃蛇小游戏，最大的价值不是把游戏做完，而是把Python的基础语法串起来跑一遍。输入处理、列表操作、条件判断、循环控制、函数封装，这些平时单独写很容易懂，但一旦放进一个不断变化的游戏循环里，很多隐藏问题就会冒出来。这个练手项目尤其适合刚学完Python基础、想找一个能完整运行的小项目的人。我最近又按这个思路用pygame把贪吃蛇重新写了一遍，结论是：只要环境装好，按“窗口创建 -> 蛇移动 -> 食物生成 -> 碰撞判断”的顺序拆解，新手也能在几个小时内跑出第一版。
下面直接进入正题。我会先说明这个项目到底在练什么，再给环境准备和完整源码，最后把常见的报错、边界和扩展思路一起整理出来。如果你只是想复制代码，可以直接跳到第四节；如果你想理解每一步为什么这么写，建议从头顺序看。
1. 先搞懂这个练手项目到底在练什么
1.1 它适合哪类Python学习者
这个项目适合的并不是完全没写过代码的人，而是已经认识if、for、while、列表和函数的读者。如果这些概念还没接触过，我建议先花半天把基础语法过一遍，否则看代码时会卡在“为什么这里用列表存蛇身”这类问题上。
贪吃蛇的代码量不大，一套完整可运行版本通常也就一两百行。但它的逻辑链路比普通练习复杂很多：窗口要持续刷新，键盘要实时响应，蛇的位置每帧都要更新，食物消失后要重新生成。这些东西组合在一起，正好能把零散的语法点变成一套完整程序。
更重要的是，它能让初学者感受到“写小游戏”和“写脚本”的区别。脚本往往是顺序执行一遍就结束，游戏需要在一个while循环里反复处理输入、更新状态、绘制画面。这种循环思想是很多图形程序和游戏程序的基础。
1.2 一次游戏要用到的核心语法点
先列一下这个项目里会反复用到的内容：
- 列表：蛇身用列表存储，蛇头是第一个元素，蛇尾是最后一个元素。
- 元组：坐标用
(x, y)表示，字典用方向键映射方向向量。 while循环：游戏主循环，每一帧执行一次更新。for循环：遍历蛇身绘制矩形，或者遍历事件列表。if / elif / else：判断键盘事件、判断是否撞墙、是否吃到食物。- 函数：把初始化、生成食物、绘制、检查碰撞分别封装成函数。
- 模块导入：
import pygame、import random。 - 常量定义：窗口大小、格子大小、颜色、游戏速度用大写常量统一管理。
这些点覆盖了Python基础中最常用的一部分。把它们放进一个项目的上下文里理解，比单独背语法记得更牢。
1.3 为什么游戏比打印九九乘法表更能巩固基础
打印九九乘法表确实能练习循环，但它的缺点是：无论循环多少次，外部状态几乎不变。贪吃蛇不一样，蛇身列表会越来越长，食物的位置会不断变化，游戏速度会随着得分提高。每一步都要关心“当前状态是什么”和“状态如何迁移”，这其实是编程里非常重要的思维训练。
另外，游戏项目天然有可视化反馈。代码出错时，你能直观看到画面是否正常、蛇是否乱跑、碰撞是否误判。这种即时反馈能大大提高调试效率，也能让人更有动力继续改下去。对新手来说，能看到自己写的程序变成一个能动的小游戏，比起单纯在终端里打印结果要有成就感得多。
2. 搭建运行环境：Python和pygame缺一不可
2.1 检查Python版本和pip命令
我默认你已经装好了Python。判断方式很简单：打开终端或命令行，输入：
python --version如果提示不是内部或外部命令，再试：
python3 --versionWindows下一般用python，macOS和Linux下可能要用python3。安装Python时，建议勾选“Add Python to PATH”，否则后面在命令行里找不到python命令，会很麻烦。
接着检查pip是否可用：
pip --version如果pip也没找到，可以试python -m pip --version。这一步的目的不是做表面检查，而是避免后面安装pygame时出现“找不到pip”或“把包装到了另一个Python环境”这种问题。
2.2 安装pygame并确认导入成功
贪吃蛇最常用的图形库是pygame。它专门用来做2D小游戏，已经封装了窗口、事件、图片和声音等常用功能。安装命令很简单：
pip install pygame或者使用Python模块方式：
python -m pip install pygame安装完成后，在Python交互环境或脚本里检查：
import pygame print(pygame.ver)如果打印出版本号，说明安装成功。如果报ModuleNotFoundError，先确认你执行python和pip的环境是不是同一个。很多时候用户装了多个Python版本，pip装到了3.8，但命令运行的是3.11，两边自然对不上。
2.3 如果没有pygame，还能用tkinter吗
可以。Python自带tkinter，不需要额外安装图形库。用tkinter写贪吃蛇也完全可以，只是事件处理方式不同：pygame用pygame.event.get()轮询事件，tkinter用bind绑定键盘事件。从学习目的看，两者都能巩固基础。
不过我个人建议第一次做这个项目时直接使用pygame。原因是pygame的坐标系、帧率和矩形绘制更符合游戏开发直觉，网上参考资料也多。如果你在安装pygame时遇到网络问题，可以换国内镜像源安装：
pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后再用import pygame验证一次。环境问题解决了，后面写代码才不会一头雾水。
3. 拆解贪吃蛇的四个核心模块
3.1 初始化窗口和游戏参数
第一件事是定义游戏窗口的大小和格子大小。贪吃蛇的移动是离散的，每次走一个格子，所以需要把窗口分成很多小格子。
我一般这样设定：
CELL_SIZE = 20 GRID_WIDTH = 30 GRID_HEIGHT = 20 WINDOW_WIDTH = CELL_SIZE * GRID_WIDTH WINDOW_HEIGHT = CELL_SIZE * GRID_HEIGHT这里的CELL_SIZE是每个格子的边长，单位是像素。GRID_WIDTH和GRID_HEIGHT分别是横向和纵向的格子数量。窗口总宽等于格子大小乘数量，这样蛇头坐标可以精确落在格子里，不会出现画出来对不齐的情况。
为什么不让窗口宽度直接写600，再让CELL_SIZE随便定？因为后面判断边界和生成食物时，都要依赖格子坐标。如果窗口尺寸不是格子大小的整数倍，蛇走到边缘时会出现半格偏移，碰撞判断就会变得很麻烦。先把窗口和格子解耦，后续改起来也容易。
游戏速度用一个FPS常量控制，也就是每秒刷新的帧数。FPS越低，蛇移动越慢；FPS越高，蛇移动越快。初版建议从FPS = 10开始，这个速度对新手比较友好。
3.2 蛇的移动和数据存储方式
蛇身可以用一个列表存储，每个元素是一个坐标元组。比如：
snake = [(15, 5), (14, 5), (13, 5)]这里(15, 5)是蛇头，后面两个是身体。坐标含义是“第几列、第几行”，不是像素位置。画图的时候再根据坐标乘以CELL_SIZE，得到左上角的像素位置。
蛇的移动分为四步：
- 根据当前方向
dir计算新的蛇头坐标。 - 把新蛇头插入列表最前面。
- 如果没有吃到食物，就把列表最后一个元素弹出。
- 如果吃到了食物，就不弹出，蛇身长度自然增加一格。
这个做法的关键是“弹出尾巴”。如果不弹出，蛇每帧都会变长，最终填满整个窗口。如果弹出的位置不对，蛇看起来就像拖着一条断尾在跑。代码里要保证弹出的顺序：先插入新头，再删除旧尾。顺序反了可能吃到食物时丢掉尾巴，或者没吃到食物时蛇头跑到错误位置。
方向控制上，需要做“禁止反向”的判断。否则蛇正在向右走时按左键，蛇头会直接穿进身体。常见写法是：新方向与当前方向相加不等于零向量时，才允许更新方向。例如当前方向是(1, 0)，新方向(-1, 0)相加等于(0, 0)，说明是反向，此时忽略按键。
3.3 食物生成逻辑
食物可以用一个坐标元组表示，例如food = (5, 5)。每次生成食物时，需要保证食物不在蛇身上。最简单的做法是：
while True: food = (random.randint(0, GRID_WIDTH - 1), random.randint(0, GRID_HEIGHT - 1)) if food not in snake: break这里random.randint(0, GRID_WIDTH - 1)生成的是0到29之间的整数，对应横向格子索引。为什么不从1开始？因为蛇头坐标也允许在0到29之间，如果从1开始，边缘的一圈就永远不会有食物，看起来不够自然。
食物生成后要判断是否被蛇吃到。判断条件通常是：蛇头坐标等于食物坐标。如果相等，就把一个“需要增长”的标记设为True。在下一次移动时，不弹出蛇尾，蛇就增长了一格。
还有一个细节：如果蛇很长，几乎占满了整个窗口，while循环可能会尝试很多次才找到空位。对于贪吃蛇来说，这种概率很低，可以忽略。但如果要追求严谨，可以把所有空格子收集到一个列表里，再从中随机选一个，这样每次生成效率都稳定。初版可以不用纠结，先跑通再说。
3.4 碰撞检测和死亡判定
贪吃蛇的死亡条件有两个：撞墙和撞自己。
撞墙的判断很简单：
if new_head[0] < 0 or new_head[0] >= GRID_WIDTH or new_head[1] < 0 or new_head[1] >= GRID_HEIGHT: running = False注意使用>=而不是>。因为合法下标是0到GRID_WIDTH-1，一旦等于GRID_WIDTH，就已经超出边界。
撞自己的判断稍微复杂一点。常见写法是判断新蛇头是否在蛇身列表里。但这里有个坑：如果新蛇头是用切片或复制生成的，要小心列表长度。更稳妥的方式是：
if new_head in snake_body: running = False这里的snake_body是去掉旧蛇尾后的身体。因为如果食物在尾巴的位置，可能允许蛇头移动到尾巴位置时尾巴刚好移开，从而不算碰撞。但初版可以不考虑这个细节点，直接用整个蛇身判断也够用。等你想做“完美”版本时，再根据移动顺序调整。
死亡后常见处理是弹出一段文字“Game Over”，然后pygame.quit()退出。也可以改成等待按键重新开始，后面第五节会讲。
4. 完整源码：从启动到游戏结束
4.1 完整代码
下面是我写过的一版完整代码，基于pygame实现，去掉了复杂装饰，保留了核心逻辑。代码可以直接保存为snake.py运行。
import pygame import random # 初始化 pygame.init() # 基础参数 CELL_SIZE = 20 GRID_WIDTH = 30 GRID_HEIGHT = 20 WINDOW_WIDTH = CELL_SIZE * GRID_WIDTH WINDOW_HEIGHT = CELL_SIZE * GRID_HEIGHT FPS = 10 # 颜色 BLACK = (0, 0, 0) WHITE = (255, 255, 255) RED = (200, 30, 30) GREEN = (30, 180, 60) # 方向映射 DIRECTIONS = { pygame.K_UP: (0, -1), pygame.K_DOWN: (0, 1), pygame.K_LEFT: (-1, 0), pygame.K_RIGHT: (1, 0), } # 创建窗口 screen = pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT)) pygame.display.set_caption("贪吃蛇") clock = pygame.time.Clock() # 初始状态 snake = [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] snake.append((snake[0][0] - 1, snake[0][1])) snake.append((snake[0][0] - 2, snake[0][1])) direction = (1, 0) # 初始向右移动 score = 0 font = pygame.font.Font(None, 36) def random_food(): while True: pos = (random.randint(0, GRID_WIDTH - 1), random.randint(0, GRID_HEIGHT - 1)) if pos not in snake: return pos food = random_food() def draw(): screen.fill(BLACK) # 画蛇 for i, (x, y) in enumerate(snake): rect = pygame.Rect(x * CELL_SIZE, y * CELL_SIZE, CELL_SIZE, CELL_SIZE) # 蛇头用亮色，蛇身用深色 if i == 0: pygame.draw.rect(screen, GREEN, rect) else: pygame.draw.rect(screen, (0, 120, 40), rect) # 画食物 pygame.draw.rect( screen, RED, pygame.Rect(food[0] * CELL_SIZE, food[1] * CELL_SIZE, CELL_SIZE, CELL_SIZE) ) # 显示得分 score_surface = font.render(f"Score: {score}", True, WHITE) screen.blit(score_surface, (10, 10)) # 游戏主循环 running = True game_over = False while running: # 事件处理 for event in pygame.event.get(): if event.type == pygame.QUIT: running = False elif event.type == pygame.KEYDOWN: if event.key in DIRECTIONS: new_dir = DIRECTIONS[event.key] # 禁止反向 if new_dir[0] + direction[0] != 0 or new_dir[1] + direction[1] != 0: direction = new_dir elif event.key == pygame.K_SPACE and game_over: # 重新开始 snake = [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] snake.append((snake[0][0] - 1, snake[0][1])) snake.append((snake[0][0] - 2, snake[0][1])) direction = (1, 0) score = 0 food = random_food() game_over = False if not game_over: # 计算新蛇头 head_x, head_y = snake[0] dx, dy = direction new_head = (head_x + dx, head_y + dy) # 撞墙判断 if (new_head[0] < 0 or new_head[0] >= GRID_WIDTH or new_head[1] < 0 or new_head[1] >= GRID_HEIGHT): game_over = True else: snake.insert(0, new_head) # 撞自己判断 if new_head in snake[1:]: game_over = True else: # 是否吃到食物 if new_head == food: score += 1 food = random_food() else: snake.pop() # 绘制 draw() # 游戏结束提示 if game_over: over_surface = font.render("Game Over! Press SPACE to restart", True, WHITE) screen.blit(over_surface, (WINDOW_WIDTH // 2 - 200, WINDOW_HEIGHT // 2)) pygame.display.flip() clock.tick(FPS) pygame.quit()这份代码里，按空格可以重新开始，方便测试时不反复关闭窗口。如果你不需要这个功能，可以把K_SPACE分支删掉，留下QUIT处理即可。
4.2 代码里几个容易改错的地方
第一处是颜色元组的范围。pygame里RGB每个分量通常取0到255，如果写成(0, 0, 256)，有些环境会直接报溢出错误。建议保持在0到255之间。
第二处是蛇的初始长度和方向。我定义了3个格子，初始向右。如果你改成初始向左，要注意后面的身体坐标也要保持一条直线，否则蛇在启动时会扭成奇怪形状。
第三处是撞自己的判断位置。代码里先snake.insert(0, new_head)，再判断new_head in snake[1:]。因为新蛇头已经插入列表，判断时要用snake[1:]排除掉新蛇头本身，否则永远会认为撞到自己，游戏一开局就结束。
第四处是画食物时使用pygame.Rect，它的四个参数是(x, y, width, height)，不是(x1, y1, x2, y2)。写代码时要注意不要把第四参数写成结束坐标。
4.3 如何验证代码是否正常
第一次运行前，我会做三个层面的验证。
第一，启动不报错。双击运行或命令行执行python snake.py后，窗口能正常弹出，标题栏显示“贪吃蛇”。
第二，初始画面正常。窗口里有黑色背景，绿色蛇身，一个红色食物。蛇头位置在窗口偏中间，蛇身向左延伸。
第三，操作逻辑正确。按方向键，蛇能移动；按反向键不会立刻掉头；吃掉食物后得分增加，蛇身变长；撞墙或撞自己后画面出现“Game Over”。
如果这三步都通过，说明核心逻辑没问题。之后再去扩展功能才有意义。
5. 单局跑通后，如何扩展成更像样的游戏
5.1 增加计分和速度递增
初版得分只是数字变化，玩久了会嫌单调。更常见的做法是得分越高，移动速度越快。
实现方式很简单：把clock.tick(FPS)中的FPS改成动态变量，例如：
current_speed = min(FPS + score // 5, 30) clock.tick(current_speed)每吃5个食物，速度加1，上限设为30。这里设置上限是因为速度超过30后，画面刷新很快，键盘操作难度急剧上升，反而不适合普通玩家。
如果想让速度变化更平滑，可以记录吃到食物的数量，而不是直接依赖score。因为score可能因为扩展功能而出现加分项，容易和速度挂钩混乱。
5.2 增加重新开始和暂停
初版代码已经加了空格重新开始。暂停功能也很简单，在游戏循环里增加一个暂停标记：
paused = False按P键切换暂停。暂停时只处理事件和绘制提示文字，不更新蛇的位置。注意事件处理部分要单独写一个状态判断，避免玩家在暂停时还能移动蛇。
重新开始时，需要把所有状态重置：蛇身恢复初始长度，方向恢复向右，分数归零，食物重新随机生成，游戏结束标记设为False。这些代码可以封装成一个reset_game()函数，避免在按键分支里写一大串重复代码。
5.3 增加简单排行榜或最高分记录
如果你想练一下文件读写，可以把最高分保存到一个txt文件里。每次游戏结束时，判断当前得分是否大于历史最高分，如果大于则写入文件。
try: with open("high_score.txt", "r") as f: high_score = int(f.read().strip()) except FileNotFoundError: high_score = 0这里使用try except是为了处理文件不存在的情况。第一次运行时没有历史记录，直接让最高分为0。
当游戏结束时，再判断一次更新分数。这里要注意文件编码和换行符。读取时最好用strip()去掉空白，否则int()可能会因为换行符报错。写入时用str(high_score)写入整数。这个扩展能帮你练习异常处理和文件操作，算是从游戏逻辑跳到通用编程能力的过渡。
6. 常见报错和排查顺序
6.1 启动时报 ModuleNotFoundError
最常见的原因是pygame没有安装成功。先执行：
pip show pygame如果显示WARNING: Package(s) not found，说明确实没装上。接着执行pip install pygame。
如果已经装上了还是报错，就要怀疑Python环境不一致。比如你用pip安装，但运行脚本时用的是另一个解释器。可以这样验证：
python -c "import pygame; print(pygame.ver)"如果这个命令能正常打印版本号，但运行snake.py却报错，检查脚本文件是不是被命名成了pygame.py。如果脚本名字和库名相同，Python导入时会优先导入当前目录下的同名文件，导致找不到真实的pygame。这个问题很隐蔽，我见过不少人踩坑。
6.2 窗口一闪而过
窗口出现后立刻关闭，多半是脚本抛出了异常。因为pygame窗口模式下，如果代码运行到pygame.quit()或抛出未捕获异常，控制台会显示错误，但窗口可能已经退出。
解决办法是不要直接双击运行，而是在命令行里执行脚本：
python snake.py这样能看到完整的报错信息。常见错误包括：未初始化pygame就使用相关函数、坐标越界、函数名拼写错误。排查时先看终端里的Traceback，定位到具体行，再根据错误类型修正。
6.3 方向键没反应或蛇反向移动
方向键没反应，先确认事件类型是不是pygame.KEYDOWN。有些例子用KEYUP，那就可能只在按键弹起时触发，手感会很奇怪。本项目使用KEYDOWN，按下即触发。
反向移动的原因是方向更新逻辑没有过滤掉180度掉头。检查代码里是否写了下述判断：
if new_dir[0] + direction[0] != 0 or new_dir[1] + direction[1] != 0: direction = new_dir如果你直接写成direction = new_dir，那么快速连按“上、左”时，蛇可能瞬间掉头并撞进自己身体。注意这个判断要在同一帧事件处理中反复执行时仍然有效，如果玩家在同一个帧内按了多个键，最终方向会以最后一个合法方向为准，这是正常现象。
6.4 蛇撞到身体却没有结束
这个现象通常是“允许蛇头移动到蛇尾原位置”造成的。因为蛇在移动时，如果尾部会同时移开，那么蛇头可以安全地移动到尾巴之前的位置。但判断碰撞如果用整体蛇身，在新蛇头等于旧尾巴时会被误判为碰撞，于是游戏提前结束。
解决办法是：先判断是否吃到食物。如果吃到食物，尾巴不弹出，此时蛇头撞到尾巴就是真撞；如果没吃到食物，尾巴即将弹出，新蛇头等于旧尾巴不算撞。具体实现可以这样：
if new_head == food: # 增长，不弹出尾巴，所以旧尾巴还在，撞到就算撞 snake.insert(0, new_head) if new_head in snake[1:]: game_over = True else: score += 1 food = random_food() else: # 先弹出尾巴，再判断碰撞 tail = snake[-1] snake.pop() snake.insert(0, new_head) # 注意此时旧尾巴已经不在蛇身里 if new_head in snake[1:]: game_over = True不过初版直接用整体蛇身判断也能玩，只是偶尔会在靠近尾巴时提前判定。如果你想做出“完美”手感，就需要关注这个细节。
7. 容易被忽略的边界和性能细节
7.1 窗口大小的取整问题
pygame窗口大小可以是任意整数，但贪吃蛇这种格子游戏最好保证总宽和总高是格子大小的整数倍。不然你设置GRID_WIDTH = 29、CELL_SIZE = 20，窗口宽580，没问题；但如果GRID_WIDTH取小数，pygame会直接报错。
另外，格子数量也不要设置太大。比如横向100格、纵向80格，窗口会非常大，普通屏幕根本放不下。我建议横向30到40格，纵向20到30格，配合20像素格子大小，窗口在600x400到800x600之间，比较合适。
7.2 速度并非越快越好
初版FPS = 10意味着每秒刷新10帧，蛇每秒移动10格。这个速度适合第一次测试。如果你开局就把FPS调到60，蛇会像飞一样，方向键根本来不及反应过来。
实际测试时，我建议把速度增长门槛设得高一点。比如每吃10个食物速度加1，上限为20。这样新手能玩一两分钟，又不会觉得太慢。如果想要挑战模式，可以单独做一个变量控制难度，不要把速度写死在多个地方。
7.3 蛇身列表的顺序千万不能搞反
很多变形bug都出在列表顺序上。蛇头必须是列表第一个元素，蛇尾是最后一个。绘制蛇时，如果遍历顺序错了，蛇头可能被画在蛇身下面，看起来像身体盖住了头。计算移动时，如果pop()写成pop(0)，会删掉蛇头，蛇身瞬间乱套。
我可以给一个简单的自我检查方法：打印snake[0]和snake[-1]，看看是否分别对应蛇头和蛇尾。如果蛇头坐标不是当前方向应该到达的位置，说明移动逻辑有问题。
7.4 批量测试和自动运行思路
调试游戏时，每次手动操作很慢。如果想验证碰撞逻辑，可以让蛇自动朝某个方向移动，并在特定坐标触发食物。做法是临时把键盘事件注释掉，用一套预设的方向序列让蛇自动走，观察是否在预期位置game over。
这种自动化测试思路对以后写更复杂项目很有用。游戏虽然是交互式的，但核心状态更新函数可以独立测试。比如把移动、碰撞、食物生成拆成纯函数，就可以编写测试脚本验证边界条件。这里的经验是：任何项目，只要逻辑足够清晰，都可以把自动测试加进来。小游戏也不例外。
最后一个建议：当代码跑通后，不要急着加各种炫酷功能。先保存一份初始版本，作为对照。后面改动过程中如果出现新bug，可以快速回到初始版本确认是“原有逻辑问题”还是“新扩展引入的问题”。我在实际写这个项目时就吃过亏：一开始直接加音效、动画和排行榜，结果一个bug查了很久，最后发现只是蛇身列表顺序写反了。基础逻辑不稳，功能堆得越多，排查越难。
贪吃蛇虽然只是一个练手项目，但它把Python编程里最实用的几个部分都过了一遍。如果你能不看源码，自己独立写出一版能跑的贪吃蛇，说明你已经具备了用Python处理简单状态变化的能力。这个基础上再去看Web开发、数据分析或自动化脚本，都会顺很多。
