Python贪吃蛇游戏:用pygame写完整代码(新手版)

Released: 2026年11月10日
📅 最后更新:2026年11月10日

这个 Python 贪吃蛇项目会带你从窗口初始化开始,逐步加入方向键控制、蛇身移动、食物生成、碰撞检测和分数显示。跟着六个步骤操作,最后把完整代码保存为文件即可运行。

第一步:安装 pygame 并检查运行环境

本项目需要外部库 pygame。先在终端安装,再确认 Python 能正常导入:

python -m pip install pygame
python -c "import pygame; print(pygame.version.ver)"

如果你使用 python3 启动 Python,请把命令中的 python 换成 python3。安装方式可参考用 pip 安装 pygame 指南。如果还没有配置 Python 环境,可查看新手环境安装步骤,学习 Python 基础则可从中文学习路线入手。

pygame 用来创建窗口、接收键盘事件、绘制画面并控制循环节奏;Python 代码则负责保存蛇身坐标、计算移动位置,以及判断吃到食物或发生碰撞的情况。Python 语言背景可参阅维基百科的 Python 条目。

先用一小段程序测试窗口能否启动。将代码存为 snake.py,然后运行 python snake.py。窗口出现后正常关闭,说明 pygame 已安装,窗口也能初始化。

import pygame

pygame.init()
screen = pygame.display.set_mode((600, 480))
pygame.display.set_caption("贪吃蛇")
pygame.quit()

第二步:设置游戏窗口和主循环

示例窗口尺寸为六百乘四百八十像素,每个格子宽三十像素,因此棋盘有二十列、十六行。蛇和食物都用网格坐标保存;绘制时,再将坐标乘以格子边长,换算成窗口中的像素位置。

主循环会反复完成几项工作:读取退出和键盘事件、更新游戏状态、绘制画面,再刷新窗口。事件队列需要持续读取,否则窗口可能无法及时响应。pygame 官方文档对此有说明,详见 pygame 事件模块文档。

代码使用 clock.tick(10) 将循环速度限制在每秒约十轮。每轮蛇移动一格;提高这个数值,蛇通常会移动得更快。具体手感也会受到运行环境影响。更多说明见时钟模块文档。

第三步:保存蛇身坐标并处理方向输入

蛇身由坐标列表表示,列表第一项始终是蛇头。例如 [(10, 8), (9, 8), (8, 8)] 表示蛇正朝右移动。方向用坐标增量表示:向右是 (1, 0),向下是 (0, 1)。

操作 坐标变化 方向增量
向右 列数增加 (1, 0)
向左 列数减少 (-1, 0)
向下 行数增加 (0, 1)
向上 行数减少 (0, -1)

按下方向键后,程序会拒绝与当前方向相反的输入。蛇向右移动时,不能立刻掉头向左。turn_locked 还会限制每次移动只接受一次转向,避免连续按键让蛇在一格内改变方向。

每次移动时,程序先计算新蛇头,再把它插入列表开头。若没有吃到食物,就删除列表末尾的蛇尾,长度保持不变;吃到食物时则保留蛇尾,蛇身增加一格。有关列表操作的更多内容,可参阅列表用法指南。

第四步:生成食物并增加蛇身长度

食物必须位于棋盘范围内,也不能和蛇身重叠。程序会先找出所有空格,再从中随机选一个位置。随机数模块的用法见Python 官方随机数文档。

程序先找出空格并随机放置食物;棋盘无空格时获胜,吃到食物后得十分并生成下一份食物。

棋盘没有空格时,生成食物的函数会返回 None,游戏进入获胜状态,不会继续寻找位置。虽然蛇占满棋盘的情况不常见,代码仍需妥善处理。

当新蛇头与食物坐标相同时,分数增加十分,并生成下一份食物。分数会显示在窗口左上角。

第五步:检测碰撞并运行完整游戏

如果新蛇头的列或行坐标超出棋盘范围,就表示撞墙。自撞检测则要检查新蛇头是否进入蛇身占据的位置。

这里有一个容易忽略的细节:没有吃到食物时,蛇尾会在本次移动中离开原来的格子,所以新蛇头进入旧蛇尾所在格并不算自撞。代码因此只检查 snake[:-1]。吃到食物时蛇尾不会移动,程序便检查整条蛇身。

下面是完整的 snake.py 代码。它支持方向键控制、吃食物后增长、计分、撞墙或自撞结束,以及棋盘填满后的获胜提示。游戏没有暂停或重新开始功能;结束后关闭窗口,再次运行程序即可重新开局。

import random
import pygame

# 初始化窗口、颜色和棋盘
pygame.init()
CELL = 30
COLS, ROWS = 20, 16
WIDTH, HEIGHT = COLS * CELL, ROWS * CELL
FPS = 10

screen = pygame.display.set_mode((WIDTH, HEIGHT))
pygame.display.set_caption("Python 贪吃蛇")
clock = pygame.time.Clock()
font = pygame.font.Font(None, 32)
small_font = pygame.font.Font(None, 28)

BLACK = (20, 22, 28)
GRID = (38, 42, 50)
GREEN = (70, 210, 120)
DARK_GREEN = (35, 150, 85)
RED = (240, 80, 80)
WHITE = (245, 245, 245)

def create_food(snake):
    """从未被蛇占用的格子中挑选食物位置。"""
    empty_cells = [
        (x, y)
        for y in range(ROWS)
        for x in range(COLS)
        if (x, y) not in snake
    ]
    return random.choice(empty_cells) if empty_cells else None

def draw_cell(color, position):
    x, y = position
    rect = pygame.Rect(x * CELL, y * CELL, CELL, CELL)
    pygame.draw.rect(screen, color, rect.inflate(-3, -3), border_radius=5)

# 蛇头在列表首位,方向以格子为单位
snake = [(COLS // 2, ROWS // 2),
         (COLS // 2 - 1, ROWS // 2),
         (COLS // 2 - 2, ROWS // 2)]
direction = (1, 0)
pending_direction = direction
turn_locked = False
food = create_food(snake)
score = 0
game_over = False
won = False
running = True

while running:
    # 读取窗口关闭与键盘事件
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
        elif event.type == pygame.KEYDOWN and not game_over:
            choices = {
                pygame.K_UP: (0, -1),
                pygame.K_DOWN: (0, 1),
                pygame.K_LEFT: (-1, 0),
                pygame.K_RIGHT: (1, 0),
            }
            candidate = choices.get(event.key)
            if candidate and not turn_locked:
                opposite = (-direction[0], -direction[1])
                if candidate != opposite:
                    pending_direction = candidate
                    turn_locked = True

    if not game_over:
        direction = pending_direction
        head_x, head_y = snake[0]
        next_head = (head_x + direction[0], head_y + direction[1])
        ate_food = next_head == food

        # 撞墙检查
        x, y = next_head
        hit_wall = x < 0 or x >= COLS or y < 0 or y >= ROWS

        # 未吃食物时,蛇尾会离开旧格,因此不把旧尾格算作碰撞
        body_to_check = snake if ate_food else snake[:-1]
        hit_self = next_head in body_to_check

        if hit_wall or hit_self:
            game_over = True
        else:
            snake.insert(0, next_head)
            if ate_food:
                score += 10
                food = create_food(snake)
                if food is None:
                    game_over = True
                    won = True
            else:
                snake.pop()

        turn_locked = False

    # 绘制棋盘、食物、蛇和分数
    screen.fill(BLACK)
    for x in range(0, WIDTH, CELL):
        pygame.draw.line(screen, GRID, (x, 0), (x, HEIGHT))
    for y in range(0, HEIGHT, CELL):
        pygame.draw.line(screen, GRID, (0, y), (WIDTH, y))

    if food is not None:
        draw_cell(RED, food)

    for index, part in enumerate(snake):
        draw_cell(GREEN if index == 0 else DARK_GREEN, part)

    score_text = font.render(f"Score: {score}", True, WHITE)
    screen.blit(score_text, (8, 8))

    if game_over:
        message = "You win!" if won else "Game over"
        end_text = font.render(message, True, WHITE)
        hint_text = small_font.render("Close the window to quit", True, WHITE)
        screen.blit(end_text, end_text.get_rect(center=(WIDTH // 2, HEIGHT // 2 - 18)))
        screen.blit(hint_text, hint_text.get_rect(center=(WIDTH // 2, HEIGHT // 2 + 18)))

    pygame.display.flip()
    clock.tick(FPS)

pygame.quit()

在终端切换到文件所在目录,运行:

python snake.py

窗口打开后,用方向键控制蛇。撞墙或碰到自己时,画面会显示结束提示和最终分数;关闭窗口即可退出。程序不会保存最高分,也不会自动重新开局。

第六步:排查问题并继续扩展

运行出错时,先查看终端中的完整报错,再按下面的方向检查:

现象 先检查 接着定位
找不到 pygame 是否在启动程序所用的 Python 环境中安装 执行 python -m pip show pygame,并确认运行时使用同一个 python 命令
窗口无响应 主循环是否持续调用 pygame.event.get() 检查循环中是否有耗时操作,或遗漏事件读取
方向键无效 是否处理 KEYDOWN,键值是否正确 临时打印 event.key,确认事件进入循环
蛇移动太快或太慢 FPS 数值 调整代码顶部的 FPS;每轮循环中蛇移动一格
食物似乎被遮住或重叠 生成食物时是否排除了整条蛇身 确认蛇身和食物使用相同的格子坐标体系

窗口无响应时,先确认事件读取位于持续运行的主循环中,再检查游戏状态更新是否被耗时操作阻塞。若终端显示了具体错误,应根据报错内容排查,不要只凭窗口表现猜测原因。

可选改动:加入暂停、重开或调整速度

暂停功能可以通过一个布尔状态实现:按键事件切换状态,暂停期间跳过蛇身更新,但继续读取退出事件并绘制画面。重开时,需要把蛇身、方向、食物、分数和结束状态都恢复为初始值。调整速度则可修改 FPS;改动后,重新检查方向输入和碰撞判定是否符合预期。

常见问题

pygame 是制作这个游戏的必需库吗?

运行本文的代码需要安装 pygame,因为程序用它绘制窗口、接收按键并刷新画面。蛇身移动和碰撞规则由 Python 代码处理。

怎样阻止蛇直接转向相反方向?

比较候选方向与当前方向的反向量即可。蛇向右移动时,反方向是 (-1, 0);如果输入与反方向相同,程序就拒绝这次转向。

撞墙和自撞分别怎样判断?

撞墙检查蛇头坐标是否超出行列范围;自撞检查新蛇头是否与蛇身坐标重合。没有吃食物时,检查时排除即将离开的尾格;吃到食物时,则检查整条蛇身。

怎样加入暂停或重新开始功能?

增加暂停状态,并在主循环中据此决定是否更新蛇的位置。重新开始时,一并重设蛇身、方向、食物、分数和结束标记,不要只清零分数而保留旧坐标。

完成这六步后,你就有了一个包含窗口、键盘输入、计分和碰撞检测的 Python 小游戏。接下来可以浏览 Python下载的新手练手项目入口,继续练习列表、条件判断和事件循环。

来源

Related: 更多适合新手的Python练手项目, 用列表保存蛇身坐标, 把小游戏项目写进简历

Related Resources