这个 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练手项目, 用列表保存蛇身坐标, 把小游戏项目写进简历