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

1. 项目概述为什么用Pygame做贪吃蛇是绝佳的入门选择如果你刚学完Python基础语法正愁找不到一个能串联起变量、循环、列表、函数等知识点的实战项目那用Pygame做一个贪吃蛇游戏绝对是你的不二之选。这听起来可能有点“复古”毕竟贪吃蛇是几十年前的老游戏了但恰恰是这种经典让它成为了检验编程基本功的“试金石”。它逻辑清晰边界明确但实现起来又涵盖了游戏开发最核心的几个概念游戏循环、事件处理、图形绘制、碰撞检测和状态更新。我当年就是从这个小项目开始才真正理解了“程序是如何动起来的”。Pygame这个库在Python游戏开发入门领域地位非常稳固。它不像Unity、Unreal那样庞大复杂也不像一些纯教育库那样功能简陋。Pygame提供了一套基于SDLSimple DirectMedia Layer的、足够底层的接口让你能亲手操控窗口、图像、声音和事件。这意味着你需要自己处理游戏的主循环自己管理每一帧的绘制和逻辑更新——这个过程正是理解游戏引擎底层工作原理的钥匙。做完这个项目你不仅能收获一个可玩的游戏更能建立起对实时交互程序的基本认知框架这对后续学习任何游戏框架或图形界面开发都有莫大好处。这个教程的目标读者很明确就是掌握了Python基础知道列表、字典、循环、函数但还没做过完整图形化项目的初学者。我们会从零开始一步步搭建游戏窗口绘制蛇和食物处理键盘输入实现游戏逻辑直到最终得到一个功能完整、代码结构清晰的贪吃蛇。更重要的是我会在每一步都解释“为什么这么做”并分享那些官方文档里不会写的、我踩过的坑和调试技巧。文末会提供完整的、带有详细注释的源码你可以直接运行更鼓励你逐行理解并尝试修改、扩展它。2. 环境准备与Pygame库初探2.1 Python与Pygame的安装与验证工欲善其事必先利其器。首先确保你有一个可用的Python环境。我强烈推荐使用Python 3.8或以上的版本因为它们在性能和库兼容性上表现更好。如果你还没安装Python可以去其官网下载安装包记得在安装时勾选“Add Python to PATH”选项这能省去后续配置环境变量的麻烦。安装好Python后打开你的命令行终端Windows上是CMD或PowerShellmacOS/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 项目结构与核心思路设计在开始写贪吃蛇之前我们先规划一下代码结构。一个清晰的结构能让你的思路更清晰也便于后续调试和扩展。我们不打算一开始就引入复杂的面向对象设计而是采用一种循序渐进的、函数式的方式来组织代码这样更易于理解。我们的贪吃蛇游戏核心包含以下几个部分游戏初始化设置窗口大小、标题、颜色、时钟等。游戏状态定义蛇用一个列表来存储蛇身体的每一节方块的坐标。列表的第一个元素是蛇头。食物用一个元组(x, y)来存储食物的坐标。蛇的移动方向用一个字符串或常量表示如‘RIGHT’,‘LEFT’,‘UP’,‘DOWN’。游戏分数。游戏是否结束的标志。游戏主循环这是游戏的心脏每秒运行很多次由帧率控制。每一次循环都做以下几件事处理输入检查玩家按了哪些键并相应地改变蛇的移动方向。更新游戏状态根据方向移动蛇头。检查蛇头是否吃到食物。如果吃到分数增加食物位置重置蛇身变长。检查蛇头是否撞到边界或者自己的身体。如果撞到游戏结束。绘制画面清空上一帧的画面。绘制蛇的每一节身体。绘制食物。绘制分数等文字信息。控制帧率确保游戏不会运行得过快或过慢保持稳定的体验。我们将按照这个逻辑一步步实现每个功能模块。先搭建框架再填充血肉。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]是蛇头。移动蛇分为两步根据当前方向计算新的蛇头位置。将新的蛇头插入列表的开头。如果蛇没有吃到食物则需要删除列表的最后一个元素蛇尾这样蛇就完成了一次“蠕动”。如果吃到了食物则保留蛇尾蛇身长度增加。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 Falsesnake_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-简单(FPS8) 2-普通(FPS12) 3-困难(FPS18), 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贪吃蛇完整源码”找到类似项目或者根据本文的步骤和代码块自行组装。核心逻辑均已在上文给出。这个项目虽然完成了但它的扩展潜力巨大。这里提供几个深度扩展的方向供你挑战面向对象重构将Snake、Food、Game分别定义为类。Snake类管理身体、方向、移动和绘制Food类管理位置和生成Game类管理主循环、状态和碰撞检测。这会让代码结构更清晰更易于管理复杂功能。游戏功能扩展多种食物添加不同颜色的食物有的加分多但出现时间短有的会减速有的会让蛇身变短。障碍物模式在游戏区域内随机生成固定的障碍物蛇撞上也会游戏结束。关卡系统随着分数增加提高游戏帧率速度或者缩小网格使地图相对变大。存档/读档将最高分记录到本地文件。性能与代码优化双缓冲我们目前使用的是单缓冲绘制过程可能会产生闪烁。Pygame 可以通过pygame.display.set_mode的 flags 参数开启双缓冲pygame.DOUBLEBUF。脏矩形更新目前我们每一帧都重绘整个屏幕pygame.display.flip()。当游戏元素不多时没问题。如果元素很多可以只更新屏幕上发生变化的部分“脏矩形”使用pygame.display.update(dirty_rects)来提升性能。使用精灵SpritePygame 提供了pygame.sprite.Sprite类和pygame.sprite.Group类来更高效地管理、绘制和检测大量游戏对象。这是开发更复杂2D游戏的推荐方式。从这个小项目出发你实际上已经踏入了游戏开发的大门。理解了游戏循环、状态机、碰撞检测这些核心概念后再去学习像Pygame Zero、Arcade这类更高级的库或者尝试用Pygame复现其他经典游戏如打砖块、坦克大战都会变得有章可循。编程学习最好的方法就是动手去做然后不断地“折腾”它增加功能优化代码在这个过程中你的能力会得到最扎实的提升。