Python Pygame贪吃蛇实战：从零掌握游戏循环与碰撞检测

1. 项目概述：为什么用Pygame做贪吃蛇是绝佳的入门选择

如果你刚学完Python基础语法，正愁找不到一个能串联起变量、循环、列表、函数等知识点的实战项目，那用Pygame做一个贪吃蛇游戏，绝对是你的不二之选。这听起来可能有点“复古”，毕竟贪吃蛇是几十年前的老游戏了，但恰恰是这种经典，让它成为了检验编程基本功的“试金石”。它逻辑清晰，边界明确，但实现起来又涵盖了游戏开发最核心的几个概念：游戏循环、事件处理、图形绘制、碰撞检测和状态更新。我当年就是从这个小项目开始，才真正理解了“程序是如何动起来的”。

Pygame这个库，在Python游戏开发入门领域，地位非常稳固。它不像Unity、Unreal那样庞大复杂，也不像一些纯教育库那样功能简陋。Pygame提供了一套基于SDL（Simple DirectMedia Layer）的、足够底层的接口，让你能亲手操控窗口、图像、声音和事件。这意味着你需要自己处理游戏的主循环，自己管理每一帧的绘制和逻辑更新——这个过程，正是理解游戏引擎底层工作原理的钥匙。做完这个项目，你不仅能收获一个可玩的游戏，更能建立起对实时交互程序的基本认知框架，这对后续学习任何游戏框架或图形界面开发都有莫大好处。

这个教程的目标读者很明确：就是掌握了Python基础（知道列表、字典、循环、函数），但还没做过完整图形化项目的初学者。我们会从零开始，一步步搭建游戏窗口，绘制蛇和食物，处理键盘输入，实现游戏逻辑，直到最终得到一个功能完整、代码结构清晰的贪吃蛇。更重要的是，我会在每一步都解释“为什么这么做”，并分享那些官方文档里不会写的、我踩过的坑和调试技巧。文末会提供完整的、带有详细注释的源码，你可以直接运行，更鼓励你逐行理解并尝试修改、扩展它。

2. 环境准备与Pygame库初探

2.1 Python与Pygame的安装与验证

工欲善其事，必先利其器。首先确保你有一个可用的Python环境。我强烈推荐使用Python 3.8或以上的版本，因为它们在性能和库兼容性上表现更好。如果你还没安装Python，可以去其官网下载安装包，记得在安装时勾选“Add Python to PATH”选项，这能省去后续配置环境变量的麻烦。

安装好Python后，打开你的命令行终端（Windows上是CMD或PowerShell，macOS/Linux上是Terminal）。安装Pygame库非常简单，使用Python自带的包管理工具pip即可。在终端中输入以下命令：

pip install pygame

如果网络环境不佳，可以使用国内镜像源来加速下载，例如：

pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，我们需要验证一下Pygame是否安装成功，并且初步感受一下它的能力。创建一个新的Python文件，比如叫test_pygame.py，输入以下代码：

import pygame import sys # 初始化Pygame的所有模块 pygame.init() # 创建一个800x600像素的窗口 screen = pygame.display.set_mode((800, 600)) # 设置窗口标题 pygame.display.set_caption("Pygame Test Window") # 定义一种颜色，RGB格式 (红色) RED = (255, 0, 0) # 游戏主循环 running = True while running: # 处理事件队列 for event in pygame.event.get(): # 如果点击了窗口关闭按钮，则退出循环 if event.type == pygame.QUIT: running = False # 如果按下了键盘上的ESC键，也退出循环 elif event.type == pygame.KEYDOWN: if event.key == pygame.K_ESCAPE: running = False # 用白色填充整个屏幕背景，覆盖上一帧的内容 screen.fill((255, 255, 255)) # 在屏幕中央(400, 300)位置画一个半径为50的红色圆 pygame.draw.circle(screen, RED, (400, 300), 50) # 更新整个屏幕的显示 pygame.display.flip() # 退出Pygame pygame.quit() sys.exit()

运行这个脚本，你应该能看到一个白色窗口，中间有一个红色的圆。点击窗口关闭按钮或按ESC键可以退出程序。这段代码虽然简单，但已经包含了Pygame程序的骨架：初始化、创建窗口、事件循环、图形绘制、刷新屏幕。理解这个流程至关重要。

注意：有些教程可能会使用pygame.display.update()而不是pygame.display.flip()。两者的区别在于，flip()会更新整个屏幕，而update()可以只更新屏幕的一部分（通过传递一个矩形区域参数），或者在不传递参数时和flip()效果一样。在简单应用中，两者可以互换，但理解其区别对后续优化性能有帮助。

2.2 项目结构与核心思路设计

在开始写贪吃蛇之前，我们先规划一下代码结构。一个清晰的结构能让你的思路更清晰，也便于后续调试和扩展。我们不打算一开始就引入复杂的面向对象设计，而是采用一种循序渐进的、函数式的方式来组织代码，这样更易于理解。

我们的贪吃蛇游戏核心包含以下几个部分：

1. 游戏初始化：设置窗口大小、标题、颜色、时钟等。
2. 游戏状态定义：
   • 蛇：用一个列表来存储蛇身体的每一节（方块）的坐标。列表的第一个元素是蛇头。
   • 食物：用一个元组(x, y)来存储食物的坐标。
   • 蛇的移动方向：用一个字符串或常量表示，如‘RIGHT’,‘LEFT’,‘UP’,‘DOWN’。
   • 游戏分数。
   • 游戏是否结束的标志。
3. 游戏主循环：这是游戏的心脏，每秒运行很多次（由帧率控制）。每一次循环都做以下几件事：
   • 处理输入：检查玩家按了哪些键，并相应地改变蛇的移动方向。
   • 更新游戏状态：
     • 根据方向移动蛇头。
     • 检查蛇头是否吃到食物。如果吃到，分数增加，食物位置重置，蛇身变长。
     • 检查蛇头是否撞到边界或者自己的身体。如果撞到，游戏结束。
   • 绘制画面：
     • 清空上一帧的画面。
     • 绘制蛇的每一节身体。
     • 绘制食物。
     • 绘制分数等文字信息。
   • 控制帧率：确保游戏不会运行得过快或过慢，保持稳定的体验。

我们将按照这个逻辑，一步步实现每个功能模块。先搭建框架，再填充血肉。

3. 贪吃蛇游戏核心逻辑实现

3.1 定义游戏常量与初始化状态

让我们开始编写主程序。首先创建一个新文件snake_game.py。开头部分，我们导入必要的库并定义一些常量。常量使用大写字母命名，这是一个良好的编程习惯，便于区分。

import pygame import sys import random from pygame.locals import * # 导入一些常用的常量，如 KEYDOWN, QUIT # 初始化pygame pygame.init() # 游戏常量定义 SCREEN_WIDTH = 800 SCREEN_HEIGHT = 600 GRID_SIZE = 20 # 游戏网格中每个格子的大小（像素） GRID_WIDTH = SCREEN_WIDTH // GRID_SIZE GRID_HEIGHT = SCREEN_HEIGHT // GRID_SIZE FPS = 10 # 游戏帧率，控制蛇的移动速度 # 方向常量，用元组表示 (x_change, y_change) UP = (0, -1) DOWN = (0, 1) LEFT = (-1, 0) RIGHT = (1, 0) # 颜色定义 (R, G, B) BACKGROUND_COLOR = (15, 56, 15) # 深绿色背景，模拟老式屏幕 SNAKE_COLOR = (50, 205, 50) # 亮绿色蛇身 SNAKE_HEAD_COLOR = (34, 139, 34) # 稍深一点的绿色蛇头 FOOD_COLOR = (220, 20, 60) # 红色食物 TEXT_COLOR = (255, 255, 255) # 白色文字 # 初始化游戏窗口 screen = pygame.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT)) pygame.display.set_caption('经典贪吃蛇 - Pygame版') clock = pygame.time.Clock() # 创建时钟对象，用于控制帧率 font = pygame.font.SysFont(None, 36) # 创建字体对象，用于显示分数

这里有几个关键点：

• 网格化：我们没有让蛇和食物在屏幕上任意像素点移动，而是引入了GRID_SIZE的概念。蛇和食物的坐标都是基于这个网格的。例如，坐标(5, 3)表示屏幕上的(5*GRID_SIZE, 3*GRID_SIZE)像素点。这样做极大地简化了碰撞检测和移动逻辑，蛇每次移动就是一格。
• 方向表示：我们用(x_change, y_change)这样的元组来表示方向。UP就是(0, -1)，意味着纵坐标减少一格（因为屏幕坐标系原点在左上角）。这种表示法在后续移动蛇头时非常方便，直接坐标相加即可。
• 颜色选择：选择了一套比较协调的颜色，深绿背景有复古感，亮绿的蛇身和红色的食物对比鲜明，易于辨认。

接下来，我们编写几个核心的游戏函数。

3.2 核心功能函数实现

3.2.1 蛇的移动与生长逻辑

蛇的核心数据结构是一个列表，列表中的每个元素是一个表示坐标的元组(x, y)。列表的第一个元素snake_body[0]是蛇头。

移动蛇分为两步：

1. 根据当前方向，计算新的蛇头位置。
2. 将新的蛇头插入列表的开头。
3. 如果蛇没有吃到食物，则需要删除列表的最后一个元素（蛇尾），这样蛇就完成了一次“蠕动”。如果吃到了食物，则保留蛇尾，蛇身长度增加。

def move_snake(snake_body, direction): """根据方向移动蛇，返回新的蛇身体列表""" head_x, head_y = snake_body[0] # 获取当前蛇头坐标 # 计算新的蛇头坐标 new_head = (head_x + direction[0], head_y + direction[1]) # 将新的蛇头插入列表最前面 new_snake_body = [new_head] + snake_body return new_snake_body def grow_snake(snake_body): """让蛇生长一节（实际上就是在移动后不删除蛇尾）""" # 这个函数看起来简单，但逻辑已融入主循环。 # 当吃到食物时，我们调用 move_snake 后，直接使用返回的新列表，而不进行pop操作。 pass # 具体逻辑在主循环中体现

3.2.2 食物的随机生成

食物不能出现在蛇的身体上。因此，生成食物的函数需要知道当前蛇身的所有坐标，然后在整个游戏网格中随机选择一个不在蛇身上的位置。

def generate_food(snake_body): """在非蛇身的位置随机生成食物""" while True: # 在网格范围内随机生成一个坐标 food_x = random.randint(0, GRID_WIDTH - 1) food_y = random.randint(0, GRID_HEIGHT - 1) food_pos = (food_x, food_y) # 如果这个位置不在蛇身体里，就返回它 if food_pos not in snake_body: return food_pos

这里使用了一个while True循环，确保每次生成的食物位置都是有效的。在蛇身很长、空闲格子很少时，这个循环可能会多跑几次，但对于我们这个规模的游戏，性能影响可以忽略不计。

3.2.3 碰撞检测：游戏结束的判断

贪吃蛇游戏结束的条件有两个：撞墙（超出边界）和撞到自己。

def check_collision(snake_body): """检查蛇是否发生碰撞，返回布尔值""" head_x, head_y = snake_body[0] # 1. 检查是否撞墙 if head_x < 0 or head_x >= GRID_WIDTH or head_y < 0 or head_y >= GRID_HEIGHT: return True # 2. 检查是否撞到自己（蛇头是否出现在蛇身的其他部分） if snake_body[0] in snake_body[1:]: return True return False

snake_body[1:]是列表切片，获取从第二个元素到最后一个元素的子列表，即除了蛇头以外的所有身体部分。用in操作符判断蛇头是否在这个子列表中，非常简洁高效。

3.3 游戏主循环的搭建与整合

现在，我们把所有的零件组装起来，构建游戏的主循环。这是整个游戏逻辑的调度中心。

def main(): # 初始化游戏状态 snake_body = [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] # 蛇初始在屏幕中央，长度为1 direction = RIGHT # 初始方向向右 food_pos = generate_food(snake_body) # 生成第一个食物 score = 0 game_over = False # 游戏主循环 while True: # --- 事件处理部分 --- for event in pygame.event.get(): if event.type == QUIT: pygame.quit() sys.exit() if event.type == KEYDOWN: if game_over: # 游戏结束后，按空格键重新开始 if event.key == K_SPACE: # 重置游戏状态 snake_body = [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] direction = RIGHT food_pos = generate_food(snake_body) score = 0 game_over = False else: # 游戏进行中，处理方向键 # 这里有一个关键逻辑：不能直接反向移动（例如向右时不能立即向左） if event.key == K_UP and direction != DOWN: direction = UP elif event.key == K_DOWN and direction != UP: direction = DOWN elif event.key == K_LEFT and direction != RIGHT: direction = LEFT elif event.key == K_RIGHT and direction != LEFT: direction = RIGHT if game_over: # 如果游戏结束，只显示结束画面，不更新游戏逻辑 # 绘制逻辑放在后面统一处理 pass else: # --- 游戏状态更新部分 --- # 1. 移动蛇 new_head = (snake_body[0][0] + direction[0], snake_body[0][1] + direction[1]) snake_body.insert(0, new_head) # 将新蛇头加入身体 # 2. 检查是否吃到食物 if snake_body[0] == food_pos: # 吃到食物，分数增加，生成新食物，蛇身（因已插入新头且未删尾）自然增长 score += 10 food_pos = generate_food(snake_body) # 播放一个简单的吃食物音效（可选，需要音效文件） # eat_sound.play() else: # 没吃到食物，删除蛇尾，保持长度不变 snake_body.pop() # 3. 检查碰撞 if check_collision(snake_body): game_over = True # 播放游戏结束音效（可选） # game_over_sound.play() # --- 画面绘制部分 --- # 清屏，用背景色填充 screen.fill(BACKGROUND_COLOR) # 绘制网格线（可选，有助于看清位置） for x in range(0, SCREEN_WIDTH, GRID_SIZE): pygame.draw.line(screen, (30, 90, 30), (x, 0), (x, SCREEN_HEIGHT)) for y in range(0, SCREEN_HEIGHT, GRID_SIZE): pygame.draw.line(screen, (30, 90, 30), (0, y), (SCREEN_WIDTH, y)) # 绘制蛇 for i, (segment_x, segment_y) in enumerate(snake_body): color = SNAKE_HEAD_COLOR if i == 0 else SNAKE_COLOR # 蛇头用不同颜色 rect = pygame.Rect(segment_x * GRID_SIZE, segment_y * GRID_SIZE, GRID_SIZE, GRID_SIZE) pygame.draw.rect(screen, color, rect) # 给蛇身方块画一个内边框，更有立体感 pygame.draw.rect(screen, (20, 80, 20), rect, 1) # 绘制食物 food_rect = pygame.Rect(food_pos[0] * GRID_SIZE, food_pos[1] * GRID_SIZE, GRID_SIZE, GRID_SIZE) pygame.draw.rect(screen, FOOD_COLOR, food_rect) # 给食物画一个圆形的内圈，让它看起来更像苹果 pygame.draw.circle(screen, (255, 100, 100), food_rect.center, GRID_SIZE // 3) # 绘制分数 score_text = font.render(f'得分: {score}', True, TEXT_COLOR) screen.blit(score_text, (10, 10)) # 如果游戏结束，绘制结束信息 if game_over: game_over_text = font.render('游戏结束! 按空格键重新开始', True, (255, 50, 50)) text_rect = game_over_text.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//2)) screen.blit(game_over_text, text_rect) final_score_text = font.render(f'最终得分: {score}', True, TEXT_COLOR) final_score_rect = final_score_text.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//2 + 40)) screen.blit(final_score_text, final_score_rect) # --- 刷新屏幕并控制帧率 --- pygame.display.flip() clock.tick(FPS) # 确保循环每秒最多运行FPS次 if __name__ == '__main__': main()

实操心得：在主循环中，事件处理、状态更新、画面绘制的顺序非常重要。通常的顺序是：先处理所有输入事件，然后根据输入和上一帧的状态更新当前游戏世界的数据，最后根据最新的数据绘制画面。这个模式在游戏开发中被称为“处理-更新-渲染”循环，几乎适用于所有实时交互程序。

4. 功能增强与代码优化

一个基础版本已经完成了。但要让游戏更完善、代码更健壮，我们还需要做一些增强和优化。

4.1 增加游戏开始界面与难度选择

目前游戏直接开始，缺乏一个友好的开始界面。我们可以增加一个开始状态。

def show_start_screen(): """显示开始界面""" screen.fill(BACKGROUND_COLOR) title_font = pygame.font.SysFont(None, 72) instruction_font = pygame.font.SysFont(None, 36) title_text = title_font.render('贪吃蛇大冒险', True, (50, 205, 50)) title_rect = title_text.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//3)) screen.blit(title_text, title_rect) instr_text = instruction_font.render('按数字键选择难度: 1-简单(FPS=8) 2-普通(FPS=12) 3-困难(FPS=18)', True, TEXT_COLOR) instr_rect = instr_text.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//2)) screen.blit(instr_text, instr_rect) start_text = instruction_font.render('按对应数字键开始游戏', True, (255, 255, 100)) start_rect = start_text.get_rect(center=(SCREEN_WIDTH//2, SCREEN_HEIGHT//2 + 50)) screen.blit(start_text, start_rect) pygame.display.flip() waiting = True selected_fps = FPS # 默认帧率 while waiting: for event in pygame.event.get(): if event.type == QUIT: pygame.quit() sys.exit() if event.type == KEYDOWN: if event.key == K_1: selected_fps = 8 waiting = False elif event.key == K_2: selected_fps = 12 waiting = False elif event.key == K_3: selected_fps = 18 waiting = False clock.tick(FPS) return selected_fps

然后，修改main()函数的开头，先调用show_start_screen()获取玩家选择的帧率（即难度，帧率越高蛇移动越快），并将这个selected_fps传入主循环的clock.tick()中。

4.2 优化蛇的移动与控制手感

在基础版本中，我们禁止了直接反向移动（比如向右时不能立即按左键）。但这里还有一个细微的问题：如果在一次游戏循环（一帧）内快速按了多个方向键，只有最后一个会被记录，这可能导致“误吞”按键。例如，蛇向右移动，玩家想向下走，快速按了“下、左”，如果处理不当，蛇可能会直接向左走（因为最后按的是左），导致撞到自己。我们的代码由于是在事件循环中即时修改direction，且有一帧的时间间隔，通常不会出现严重问题，但更严谨的做法是设置一个next_direction变量，在主循环的事件处理部分只更新它，然后在状态更新部分再将其赋值给direction，这样可以确保一帧内只改变一次方向。

# 在游戏状态初始化部分 current_direction = RIGHT next_direction = RIGHT # 在事件处理部分（游戏进行中） if event.key == K_UP and current_direction != DOWN: next_direction = UP elif event.key == K_DOWN and current_direction != UP: next_direction = DOWN # ... 类似处理 LEFT 和 RIGHT # 在状态更新部分，移动蛇之前 current_direction = next_direction # 然后使用 current_direction 来移动蛇

4.3 添加音效与视觉反馈

游戏缺少音效会显得单调。Pygame 支持播放WAV和OGG格式的音效。我们可以为吃到食物和游戏结束添加简单的音效。

# 在初始化部分，加载音效（确保项目目录下有这些声音文件） try: eat_sound = pygame.mixer.Sound('eat.wav') game_over_sound = pygame.mixer.Sound('game_over.wav') except: print("警告：未找到音效文件，游戏将继续但没有声音。") eat_sound = None game_over_sound = None # 在吃到食物时播放 if eat_sound: eat_sound.play() # 在游戏结束时播放 if game_over_sound: game_over_sound.play()

视觉上，除了改变颜色，还可以在蛇吃到食物时，让食物位置有一个简单的缩放动画，或者添加一个分数增加的飘字效果。这需要引入更复杂的状态管理和绘制逻辑，可以作为后续的扩展练习。

5. 完整源码与深度扩展思路

将上述所有代码模块整合，并添加详细的注释，就得到了一个功能完整、结构清晰的贪吃蛇游戏。由于篇幅限制，完整的、整合了开始界面和优化控制的代码大约有200行。你可以直接运行它，并通过方向键控制蛇的移动。

完整源码获取：考虑到文章长度和阅读体验，完整的、带有详尽注释的源码文件已单独整理。你可以通过常见的代码托管平台搜索“Pygame贪吃蛇完整源码”找到类似项目，或者根据本文的步骤和代码块自行组装。核心逻辑均已在上文给出。

这个项目虽然完成了，但它的扩展潜力巨大。这里提供几个深度扩展的方向，供你挑战：

1. 面向对象重构：将Snake、Food、Game分别定义为类。Snake类管理身体、方向、移动和绘制；Food类管理位置和生成；Game类管理主循环、状态和碰撞检测。这会让代码结构更清晰，更易于管理复杂功能。
2. 游戏功能扩展：
   • 多种食物：添加不同颜色的食物，有的加分多但出现时间短，有的会减速，有的会让蛇身变短。
   • 障碍物模式：在游戏区域内随机生成固定的障碍物，蛇撞上也会游戏结束。
   • 关卡系统：随着分数增加，提高游戏帧率（速度），或者缩小网格使地图相对变大。
   • 存档/读档：将最高分记录到本地文件。
3. 性能与代码优化：
   • 双缓冲：我们目前使用的是单缓冲，绘制过程可能会产生闪烁。Pygame 可以通过pygame.display.set_mode的 flags 参数开启双缓冲（pygame.DOUBLEBUF）。
   • 脏矩形更新：目前我们每一帧都重绘整个屏幕（pygame.display.flip()）。当游戏元素不多时没问题。如果元素很多，可以只更新屏幕上发生变化的部分（“脏矩形”），使用pygame.display.update(dirty_rects)来提升性能。
   • 使用精灵（Sprite）：Pygame 提供了pygame.sprite.Sprite类和pygame.sprite.Group类来更高效地管理、绘制和检测大量游戏对象。这是开发更复杂2D游戏的推荐方式。

从这个小项目出发，你实际上已经踏入了游戏开发的大门。理解了游戏循环、状态机、碰撞检测这些核心概念后，再去学习像Pygame Zero、Arcade这类更高级的库，或者尝试用Pygame复现其他经典游戏如打砖块、坦克大战，都会变得有章可循。编程学习，最好的方法就是动手去做，然后不断地“折腾”它，增加功能，优化代码，在这个过程中，你的能力会得到最扎实的提升。