Python游戏编程快速上手:用Pygame制作第一个贪吃蛇

竹里
竹里
发布时间:2026-11-18| 5人浏览过
原创

本文面向Python编程初学者,详细讲解如何使用Pygame库从零开始制作经典贪吃蛇游戏。内容涵盖环境安装、主循环构建、网格移动逻辑、碰撞检测与完整可运行代码。

制作一个贪吃蛇游戏是掌握游戏编程基本范式最直接的途径。本文将使用 Python 的经典游戏开发库 Pygame,从基础环境搭建、核心游戏循环、网格化位移模型到碰撞判定,逐步实现一个规则完整、操作流畅的贪吃蛇游戏。

一、开发路径与核心机制概述

很多初学者在编写游戏时容易陷入面向过程的迷茫:画面为什么会动?按键如何影响画面?在控制台脚本中,程序通常是顺序执行到末尾结束;而游戏的核心是一个不断重复运行的“主循环”(Game Loop)。每一帧循环中,程序按照固定次序完成三项任务:收集输入事件、更新所有对象的数据状态、重新绘制并刷新屏幕。

贪吃蛇的逻辑可以拆解为四个主要阶段:环境与基础窗口初始化、构建主循环框架、实现蛇身与食物的数据模型、建立碰撞检测与规则闭环。按照这四个阶段推进,可以确保每一步都可观察、可调试。

Python游戏编程快速上手:用Pygame制作第一个贪吃蛇
图 1:Pygame 贪吃蛇项目实现的四个递进步骤

二、环境准备与基础窗口初始化

在编写代码前,需确认 Python 环境已就绪。Pygame 并不属于 Python 标准库,需要单独通过 pip 进行安装。在终端或命令行执行以下命令:

pip install pygame

安装完成后,我们首先验证窗口的正常呼出与事件循环。一个最小化的 Pygame 应用程序骨架包含以下三要素:

  • pygame.init():初始化 Pygame 包含的所有子模块(显示、音频、字体等)。
  • pygame.display.set_mode((width, height)):创建指定分辨率的图形窗口,返回用于绘图的 Surface 表面对象。
  • pygame.time.Clock():用于限制每秒渲染帧数(FPS),防止不同性能的电脑运行速度差异过大。

如果没有事件监听循环,创建出的窗口会在瞬间弹起并闪退。因此必须在 while True 循环中遍历 pygame.event.get(),当监听到用户点击窗口右上角的关闭按钮(pygame.QUIT)时安全退出。

三、核心机制:网格化坐标系与蛇身移动模型

虽然计算机屏幕的最小计量单位是物理像素(Pixel),但贪吃蛇通常采用“网格离散化”的设计。假设我们设定窗口大小为 600×400 像素,每个网格单元(Cell)为 20×20 像素,那么整个游戏世界实际上是一个 30 列 × 20 行的网格矩阵。

将坐标对齐到网格能彻底避免浮点数计算误差与“未完全重叠导致的碰撞误判”。蛇与食物的坐标都以网格大小的整数倍存储。

蛇身的数据结构与“头插尾删”移动算法

蛇的身体在程序中可以用一个列表(List)来表达,列表的每个元素都是一个包含 [x, y] 的二元列表。列表的第 0 项始终代表蛇头,后续元素依次为身体的各节。

许多初学者常犯的一个错误是试图让每一节身体独立计算并沿路径转弯,这会带来极高的计算复杂度。实际上,蛇的平移可以通过非常精妙的“头插尾删”两步完成:

  1. 计算新蛇头:根据当前移动方向(例如向右移动,则新坐标为 [head_x + 20, head_y]),将新坐标插入到列表头部(索引 0 处)。
  2. 维护蛇尾:如果蛇此时没有吃到食物,执行 pop() 剔除列表最后一项。整体效果表现为蛇身向前游动了一格;如果刚好吃到食物,则跳过 pop() 操作,蛇身自然增长一格。
Python游戏编程快速上手:用Pygame制作第一个贪吃蛇
图 2:网格离散化与列表队列的头插尾删运作原理

四、碰撞判定与游戏规则闭环

一个完整的贪吃蛇必须具备明确的胜负判定条件。在每一帧更新蛇头位置后,程序需要执行三次判定检查:

1. 吃到食物检测

由于坐标均对齐到 20 像素的倍数,当 snake[0] == food_pos 时即为命中。此时更新分数,并调用食物随机生成函数。需要特别注意的是:生成的食物坐标不能落在蛇身已经占据的任意坐标上,否则会导致食物“隐形”在蛇肚子里的异常。

2. 撞墙判定(边界越界)

窗口的有效像素范围在横向为 0 <= x < WINDOW_WIDTH,纵向为 0 <= y < WINDOW_HEIGHT。一旦新蛇头的横纵坐标超出该范围,判定游戏失败。

3. 咬到自身判定

检查蛇头的新坐标是否存在于除了头部以外的身体切片中:snake[0] in snake[1:]。如果存在,说明发生了身体交叉重叠,判定游戏结束。

Python游戏编程快速上手:用Pygame制作第一个贪吃蛇
图 3:每一帧主循环中碰撞逻辑的状态判断与行为分支

避坑细节:防止反向自杀
当蛇正在向右移动时,如果玩家直接按下左方向键,在物理逻辑上蛇不能原地掉头,否则会立即咬到第 2 节身体导致暴毙。因此在处理键盘输入时,必须加入逻辑防护:只有当当前方向不与输入方向相反时,才允许修改移动方向。

五、完整代码实现与运行验证

下面给出一份无需任何额外资源文件、能够直接在安装了 Pygame 的环境中运行的完整贪吃蛇源码。该代码把常量配置、食物生成与核心游戏流程统一收敛,便于逐行研读和运行验证。

import pygame
import random
import sys

# 1. 初始化常量设置
WINDOW_WIDTH = 640
WINDOW_HEIGHT = 480
CELL_SIZE = 20

# 校验网格必须整除
assert WINDOW_WIDTH % CELL_SIZE == 0
assert WINDOW_HEIGHT % CELL_SIZE == 0

# 颜色定义 (RGB)
COLOR_BG = (248, 250, 252)         # 背景浅白
COLOR_GRID = (226, 232, 240)       # 网格细线
COLOR_SNAKE_HEAD = (45, 58, 75)    # 蛇头深蓝灰
COLOR_SNAKE_BODY = (82, 103, 125)  # 蛇身主蓝灰
COLOR_FOOD = (166, 108, 91)        # 食物赭红
COLOR_TEXT = (30, 41, 59)          # 提示文字深色

# 移动方向向量映射
DIR_UP = (0, -CELL_SIZE)
DIR_DOWN = (0, CELL_SIZE)
DIR_LEFT = (-CELL_SIZE, 0)
DIR_RIGHT = (CELL_SIZE, 0)

def generate_food(snake_body):
    """在空闲网格中随机产生食物坐标"""
    max_x = (WINDOW_WIDTH // CELL_SIZE) - 1
    max_y = (WINDOW_HEIGHT // CELL_SIZE) - 1
    while True:
        fx = random.randint(0, max_x) * CELL_SIZE
        fy = random.randint(0, max_y) * CELL_SIZE
        if [fx, fy] not in snake_body:
            return [fx, fy]

def main():
    pygame.init()
    screen = pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT))
    pygame.display.set_caption("贪吃蛇 - Python Pygame 教程演示")
    clock = pygame.time.Clock()
    font = pygame.font.SysFont(["PingFang SC", "Microsoft YaHei", "Arial"], 22)

    # 初始状态
    snake = [[100, 100], [80, 100], [60, 100]]
    direction = DIR_RIGHT
    food = generate_food(snake)
    score = 0
    game_over = False

    while True:
        # 事件处理
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                pygame.quit()
                sys.exit()
            elif event.type == pygame.KEYDOWN:
                if game_over:
                    if event.key == pygame.K_SPACE:
                        # 重启游戏
                        snake = [[100, 100], [80, 100], [60, 100]]
                        direction = DIR_RIGHT
                        food = generate_food(snake)
                        score = 0
                        game_over = False
                else:
                    # 转向控制并杜绝直接反向掉头
                    if event.key == pygame.K_UP and direction != DIR_DOWN:
                        direction = DIR_UP
                    elif event.key == pygame.K_DOWN and direction != DIR_UP:
                        direction = DIR_DOWN
                    elif event.key == pygame.K_LEFT and direction != DIR_RIGHT:
                        direction = DIR_LEFT
                    elif event.key == pygame.K_RIGHT and direction != DIR_LEFT:
                        direction = DIR_RIGHT

        if not game_over:
            # 1. 计算新头部位置
            new_head = [snake[0][0] + direction[0], snake[0][1] + direction[1]]

            # 2. 边界碰撞检测
            hit_wall = (
                new_head[0] < 0 or new_head[0] >= WINDOW_WIDTH or
                new_head[1] < 0 or new_head[1] >= WINDOW_HEIGHT
            )
            # 3. 自相碰撞检测
            hit_self = new_head in snake

            if hit_wall or hit_self:
                game_over = True
            else:
                # 插入新头部
                snake.insert(0, new_head)
                # 检查是否吃到食物
                if new_head == food:
                    score += 1
                    food = generate_food(snake)
                else:
                    # 未吃到食物则弹出尾部
                    snake.pop()

        # 界面绘制
        screen.fill(COLOR_BG)

        # 绘制背景参考网格
        for x in range(0, WINDOW_WIDTH, CELL_SIZE):
            pygame.draw.line(screen, COLOR_GRID, (x, 0), (x, WINDOW_HEIGHT))
        for y in range(0, WINDOW_HEIGHT, CELL_SIZE):
            pygame.draw.line(screen, COLOR_GRID, (0, y), (WINDOW_WIDTH, y))

        # 绘制食物
        pygame.draw.rect(screen, COLOR_FOOD, (food[0] + 2, food[1] + 2, CELL_SIZE - 4, CELL_SIZE - 4), border_radius=4)

        # 绘制蛇身
        for index, seg in enumerate(snake):
            color = COLOR_SNAKE_HEAD if index == 0 else COLOR_SNAKE_BODY
            pygame.draw.rect(screen, color, (seg[0] + 1, seg[1] + 1, CELL_SIZE - 2, CELL_SIZE - 2), border_radius=3)

        # 绘制得分
        score_surf = font.render(f"得分: {score}", True, COLOR_TEXT)
        screen.blit(score_surf, (16, 12))

        # 游戏结束遮罩
        if game_over:
            over_surf = font.render("游戏结束!按空格键重新开始", True, COLOR_FOOD)
            over_rect = over_surf.get_rect(center=(WINDOW_WIDTH // 2, WINDOW_HEIGHT // 2))
            screen.blit(over_surf, over_rect)

        pygame.display.flip()
        # 帧率设为 10,保持经典复古操作节奏
        clock.tick(10)

if __name__ == "__main__":
    main()

运行效果与验证要点

将上述代码保存为 snake.py,在终端中执行 python snake.py 即可启动窗口。验证时可以重点关注以下表现:

  • 速度平稳:蛇以恒定速度每秒前进 10 个网格,窗口不应出现卡顿或剧烈跳帧。
  • 转向利落:按下方向键时,蛇头在下一节拍准时转弯,且高速敲击反向键不会穿身自爆。
  • 成长正确:吃到赭红色食物方块时光标瞬时变长一节,左上角计分递增,新的食物立刻刷新在空白区域。
  • 边界与结束:头部触碰四周边缘或自身躯干时,立即弹出游戏结束提示,按空格键即可重置继续。

六、项目结构与游戏运行时序总结

回顾整个制作过程,贪吃蛇虽小,却完整涵盖了商业游戏引擎同样具备的四大底层架构:初始化层、数据模型层、循环驱动层与渲染呈现层。

Python游戏编程快速上手:用Pygame制作第一个贪吃蛇
图 4:Pygame 游戏开发架构全景与运行时序关系总结

后续进阶拓展建议

在掌握了这个基础原型之后,你可以尝试在现有代码之上增加以下进阶功能,进一步深化对游戏逻辑的理解:

  1. 动态难度递增:随着得分增加,逐步调高 clock.tick() 的数值,体验由慢到快的竞速刺激。
  2. 特殊道具与障碍物:在网格中随机生成不同颜色的障碍墙或具有倒计时的金色奖励果实。
  3. 音效与视觉强化:使用 pygame.mixer.Sound 在转向、进食与失败时播放低延迟音效,提升游戏打击感。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。