这次我们来看一个非常经典的 Python 练手项目用pygame从零实现贪吃蛇小游戏。这个项目不需要 GPU、不需要显存纯 CPU 就能跑普通办公笔记本和旧电脑都可以直接运行。它的核心价值不是画面有多华丽而是把事件循环、键盘输入、坐标碰撞、画面刷新、音效播放这些游戏开发基本功全部串起来非常适合刚学完 Python 基础语法、想写第一个完整小游戏的人。从标题可以看出来这套内容通常包含三部分Python 源码、图片素材、音效素材。实际工程里对应三个核心问题游戏怎么跑起来、蛇和食物怎么渲染、吃到食物和游戏结束的音效怎么触发。素材文件如果没带你可以用自己的图片和音效替换不影响主流程。本文会从环境准备开始带你把贪吃蛇跑起来再拆解代码结构、补上资源加载、音效播放、自动测试脚本最后给一份常见的报错排查清单。这套思路尤其适合三类读者第一类是刚学完 Python 循环、列表、函数想找项目练手的人第二类是正在做课程设计或毕业设计需要交一个可运行软件的人第三类是后面想进阶写 2D 游戏、想搞懂游戏主循环机制的人。读完你不仅能运行游戏还能清楚解释每块代码为什么这么写。1. 核心能力速览先把项目的关键信息列成一张表快速判断它适不适合你能力项说明项目类型桌面小游戏 / Python 练手项目技术栈Python pygame硬件门槛不需要 GPUCPU 即可运行系统平台Windows / Linux / macOS 均可以 pygame 兼容性为准Python 版本建议使用 3.8 及以上版本具体以 pip 安装结果为准启动方式命令行运行入口脚本例如python main.py主要功能方向键控制、蛇身增长、食物生成、碰撞判定、计分、图片与音效加载是否支持 HTTP API默认不提供可通过抽离核心逻辑做自动测试批量任务不直接适用但可以做多策略自动对局脚本打包分发可以用 PyInstaller 打包成 exe 文件适合场景新手练手、课程设计、游戏开发入门这里要特别说明不要指望这个项目有复杂的 Web 服务或后台接口它是一个纯单机游戏。相关参数如分辨率、蛇移动速度、网格大小都可以在代码顶部用常量配置改起来很方便。2. 适用场景与使用边界贪吃蛇游戏的适用场景非常明确。最典型的是 Python 学习阶段的“第一个完整项目”通过它理解游戏程序最基本的运行方式初始化窗口、不断读取用户输入、更新游戏状态、刷新画面这四个步骤循环往复就是大部分 2D 游戏的核心骨架。很多人在学完列表、字典、函数之后不知道该做什么项目贪吃蛇就是难度适中的切入点。它还能承担课程设计或者简历项目的角色。一个结构清晰、带音效和图片资源、能正常打包的 pygame 游戏放在作品集里比写十个控制台练习更有说服力。你可以在此基础上继续加功能比如排行榜、暂停菜单、不同关卡速度、AI 自动寻路逐步把它做成一个“看起来比较完整”的小应用。不过也要说清楚边界。pygame 适合做轻量级 2D 游戏不适合做大型 3D 网游也不适合性能要求极高的渲染场景。它的开发效率高但底层 API 比较简单复杂物理效果、网络同步都要自己实现做商业级项目需要换引擎。另一个边界是资源版权项目里用到的图片、音效素材如果来自网络要确认授权范围尤其不要从商业游戏里直接抠图抠音效课程展示自用还好公开分享或商用必须换成有明确授权的素材或者自己制作。3. 环境准备与前置条件开始写代码之前先把 Python 环境准备好。如果你还没有安装 Python可以直接去 Python 官网下载安装包安装时务必勾选“Add Python to PATH”否则后面在命令行执行python可能找不到命令。装完后打开命令行先做两件事python --version pip --version如果这两个命令都能正常输出版本号说明 Python 环境没问题。接着创建虚拟环境避免 pygame 依赖污染系统全局环境。以项目目录snake_game为例mkdir snake_game cd snake_game python -m venv venvWindows 下激活虚拟环境venv\Scripts\activateLinux 或 macOS 下激活虚拟环境source venv/bin/activate激活后命令行前面会出现(venv)标记。然后安装 pygame。网络正常时直接执行python -m pip install pygame如果你在国内pip 默认源速度比较慢可以换成国内 PyPI 镜像。下面以清华 PyPI 镜像为例其他镜像源同理替换即可python -m pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后检查 pygame 版本python -m pip show pygame最后建议在snake_game目录下创建requirements.txt内容写一行pygame这样别人接手项目时一句python -m pip install -r requirements.txt就能装齐依赖。编辑器方面VSCode 加 Python 插件、PyCharm、甚至系统自带的 IDLE 都可以。这里不限制工具关键是能打开目录、能看到 Python 文件的语法高亮。4. 贪吃蛇核心代码实现先搭工程结构。建议目录按职责分离资源文件和代码分开放snake_game/ ├── main.py # 入口文件 ├── core.py # 可被测试的逻辑函数可选 ├── assets/ # 资源目录 │ ├── images/ # 图片素材 │ │ ├── head.png │ │ ├── body.png │ │ └── food.png │ └── sounds/ # 音效素材 │ ├── eat.wav │ └── game_over.wav ├── requirements.txt └── venv/ # 虚拟环境核心逻辑放在main.py里下面给出一套可以快速跑通的实现。先导入依赖、定义常量和初始化窗口import pygame import sys import random BACKGROUND (30, 30, 30) SNAKE_COLOR (0, 200, 0) FOOD_COLOR (255, 80, 80) TEXT_COLOR (255, 255, 255) CELL_SIZE 20 GRID_WIDTH 30 GRID_HEIGHT 20 FPS 10FPS 10表示蛇每秒移动 10 格这个数值决定游戏速度。CELL_SIZE是每格像素大小GRID_WIDTH和GRID_HEIGHT决定游戏区域的总格子数。想改窗口大小优先调整这三个数值。接着写食物生成函数。食物不能生成在蛇身上否则蛇一出生就“吃到”自己所以加一个循环判断def get_random_food(snake): while True: pos ( random.randint(0, GRID_WIDTH - 1), random.randint(0, GRID_HEIGHT - 1) ) if pos not in snake: return pos然后是游戏主函数。初始化 pygame 窗口创建蛇、食物、方向和计分变量进入主循环def main(): pygame.init() screen pygame.display.set_mode( (GRID_WIDTH * CELL_SIZE, GRID_HEIGHT * CELL_SIZE) ) pygame.display.set_caption(Python 贪吃蛇 - pygame) clock pygame.time.Clock() snake [(GRID_WIDTH // 2, GRID_HEIGHT // 2)] direction (1, 0) food get_random_food(snake) score 0 running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.KEYDOWN: if event.key pygame.K_UP and direction ! (0, 1): direction (0, -1) elif event.key pygame.K_DOWN and direction ! (0, -1): direction (0, 1) elif event.key pygame.K_LEFT and direction ! (1, 0): direction (-1, 0) elif event.key pygame.K_RIGHT and direction ! (-1, 0): direction (1, 0) head (snake[0][0] direction[0], snake[0][1] direction[1]) if ( head[0] 0 or head[0] GRID_WIDTH or head[1] 0 or head[1] GRID_HEIGHT or head in snake ): running False continue snake.insert(0, head) if head food: score 1 food get_random_food(snake) else: snake.pop() screen.fill(BACKGROUND) for segment in snake: rect pygame.Rect( segment[0] * CELL_SIZE, segment[1] * CELL_SIZE, CELL_SIZE, CELL_SIZE ) pygame.draw.rect(screen, SNAKE_COLOR, rect) food_rect pygame.Rect( food[0] * CELL_SIZE, food[1] * CELL_SIZE, CELL_SIZE, CELL_SIZE ) pygame.draw.rect(screen, FOOD_COLOR, food_rect) font pygame.font.SysFont(simhei, 24) score_surface font.render(fScore: {score}, True, TEXT_COLOR) screen.blit(score_surface, (10, 10)) pygame.display.flip() clock.tick(FPS) pygame.quit() sys.exit() if __name__ __main__: main()这段代码的重点是碰撞判断和反向控制限制。direction ! (0, 1)是为了防止蛇在向下移动时一瞬间按上导致直接撞到自己。蛇身存储方式用“坐标列表”实现蛇头永远是列表第一个元素吃到食物就只增加头部、不删除尾部没有吃到食物就正常pop()掉尾部形成移动效果。我建议你把上面的代码直接存为main.py先跑一遍确认基础版能运行之后再往下看图片、音效和自动化测试的部分。这样排查问题的时候更清晰先确认主逻辑没问题再往里面加功能。4.1 图片素材加载纯色方块版虽然能玩但视觉效果比较简陋。标题里既然包含图片资源就应该把图片加载逻辑写进工程。pygame 里加载图片用pygame.image.load()配合os.path拼接路径避免直接写死绝对路径导致换电脑报错。import os BASE_DIR os.path.dirname(os.path.abspath(__file__)) IMAGE_DIR os.path.join(BASE_DIR, assets, images) def load_image(filename, sizeNone): path os.path.join(IMAGE_DIR, filename) if not os.path.exists(path): print(f[WARN] 图片资源不存在: {path}) return None image pygame.image.load(path).convert_alpha() if size: image pygame.transform.scale(image, size) return image在main()初始化窗口之后可以先加载蛇头、蛇身、食物三张图。图片尺寸不匹配时用pygame.transform.scale统一缩放到CELL_SIZE这样任何素材都能快速适配网格head_img load_image(head.png, (CELL_SIZE, CELL_SIZE)) body_img load_image(body.png, (CELL_SIZE, CELL_SIZE)) food_img load_image(food.png, (CELL_SIZE, CELL_SIZE))绘制时优先画图片没加载到图片才退回画矩形for index, segment in enumerate(snake): rect pygame.Rect( segment[0] * CELL_SIZE, segment[1] * CELL_SIZE, CELL_SIZE, CELL_SIZE ) if index 0 and head_img: screen.blit(head_img, rect) elif body_img: screen.blit(body_img, rect) else: pygame.draw.rect(screen, SNAKE_COLOR, rect)这种“资源缺失时降级绘制”的做法很重要。它保证即使你暂时没有图片素材游戏也不会报错退出。4.2 音效素材加载游戏音效一般分成两类吃到食物的音效和游戏结束的音效。pygame 播放音效前要先初始化混音器。在pygame.init()之后做pygame.mixer.init()然后加载音效文件SOUND_DIR os.path.join(BASE_DIR, assets, sounds) def load_sound(filename): path os.path.join(SOUND_DIR, filename) if not os.path.exists(path): print(f[WARN] 音效资源不存在: {path}) return None return pygame.mixer.Sound(path)在main()里加载eat_sound load_sound(eat.wav) game_over_sound load_sound(game_over.wav)蛇吃到食物时触发eat_soundif head food: score 1 if eat_sound: eat_sound.play() food get_random_food(snake) else: snake.pop()游戏结束触发game_over_sound。注意不要在pygame.quit()之后再调用音效播放否则会报mixer not initialized。正确的做法是在退出前播放if running is False: if game_over_sound: game_over_sound.play() pygame.time.wait(500) pygame.quit() sys.exit()pygame.time.wait(500)是为了让游戏结束音效播完一小段再退出不然窗口瞬间关闭音效刚播放就被截断。具体等待时长可以根据音频长度调整。5. 安装启动与游戏入口代码写完后启动方式很简单。激活虚拟环境后在snake_game目录执行python main.py如果目录下有多个入口脚本比如start.py就把main.py换成对应文件名。启动成功后会弹出一个标题为“Python 贪吃蛇 - pygame”的窗口方向键控制蛇移动吃到红色食物后蛇身变长计分增加。如果你想把入口命令固定下来可以创建一个启动脚本。Windows 下可以写一个run.batecho off cd /d %~dp0 call venv\Scripts\activate python main.py pauseLinux 或 macOS 下可以写一个run.sh#!/usr/bin/env bash cd $(dirname $0) source venv/bin/activate python main.py注意给run.sh执行权限chmod x run.sh这类脚本适合给别人用也适合自己每次不用手动敲激活命令。不是每个 pygame 项目都会配一键启动脚本但加上之后整个工程会更完整。启动以后你可以做一次快速判断游戏窗口正常打开、蛇在窗口中央出生、按方向键能移动、撞墙后窗口能正常退出。如果这些现象都符合说明基础流程没问题。6. 功能测试与效果验证游戏类项目的测试和 Web 项目不太一样更依赖人工操作验证。下面给出一套可重复的测试步骤跑完基本能确认游戏功能完整。6.1 基本启动测试测试目标确认依赖安装正确游戏能正常进入主循环。操作步骤激活虚拟环境。执行python main.py。观察窗口是否弹出、窗口标题是否正确。预期结果窗口出现背景色为深色蛇显示在中心位置。判断标准窗口能持续显示没有报错退出。如果窗口一闪而过大概率是 Python 环境或 pygame 安装有问题回到第 3 节检查。6.2 方向控制与反向限制测试测试目标确认键盘响应正确且蛇不会瞬间掉头撞到自己。操作步骤启动游戏后依次按上、下、左、右方向键。快速在一个方向移动中按下相反方向观察是否出现非法掉头。连续快速按两个转向键观察蛇的实际移动方向。预期结果按上蛇向上走按右蛇向右走反向输入不会直接导致蛇头撞到身体。判断标准蛇的移动始终只有一个有效方向不会出现“按上后立刻向下”的穿模现象。这里容易出问题的是事件循环里没有加反向判定解决办法参考第 4 节的direction ! (0, 1)系列判断。6.3 吃食物、增长与计分测试测试目标确认食物生成、蛇身增长、分数累加逻辑正常。操作步骤控制蛇走向食物所在位置。观察蛇头与食物重合后的表现。连续吃三到五个食物观察分数变化。预期结果蛇头碰到食物后食物消失新食物在随机位置生成蛇身长度增加分数加一。判断标准蛇身每次吃食物后多一节食物不会生成在蛇身体上。如果食物生成在蛇身上说明get_random_food的判定逻辑有问题检查pos not in snake是否生效。6.4 边框与自撞测试测试目标确认游戏结束判定生效。操作步骤控制蛇一直朝墙移动不做转向。记录撞墙后的表现。再运行一次控制蛇绕圈撞向自己观察表现。预期结果蛇头碰到边界或蛇身时游戏结束窗口自动关闭。判断标准结束后进程正常退出没有残留的 Python 进程。如果撞墙后没有反应检查主循环里running False的分支是否有continue。6.5 图片和音效资源测试测试目标确认assets目录下的图片、音效能被正确加载和触发。操作步骤准备几张 PNG 图片放到assets/images。准备两个 wav 格式音效文件放到assets/sounds。启动游戏观察蛇是否显示为图片而不是纯色方块。吃食物时听音效撞墙时听结束音效。预期结果窗口里蛇头和食物不再依赖pygame.draw.rect而是显示加载的图片吃到食物有提示音游戏结束有另一段音效。判断标准控制台不打印[WARN]就是正常。如果打印了[WARN]说明路径或文件名不匹配按第 4.1 和 4.2 节的路径拼接规则检查。7. 接口 API 与批量自动化扩展严格说贪吃蛇单机项目没有 HTTP API不像 Web 服务那样能通过curl调用。但“接口”在这个项目里可以理解成代码层暴露出来的函数入口。如果你想对游戏里移动策略做自动化验证或者未来给蛇写一个 AI 自动寻路直接靠图形界面太慢必须把核心游戏逻辑抽出来用脚本批量测试。7.1 抽离核心逻辑建议把“判断下一步状态”的逻辑单独放到core.py它不依赖 pygame这样可以用命令行脚本反复调用。下面是一个抽象的移动判定函数def next_step(snake, direction, food, width, height): head (snake[0][0] direction[0], snake[0][1] direction[1]) if ( head[0] 0 or head[0] width or head[1] 0 or head[1] height or head in snake ): return None new_snake [head] snake if head food: return new_snake, True return new_snake[:-1], False返回None表示这一步会导致死亡返回(new_snake, True)表示吃到食物返回(new_snake, False)表示正常移动。这种函数不绘制窗口、不监听键盘天然适合单元测试和批量模拟。7.2 自动化批量测试脚本有了next_step可以写一个batch_test.py脚本一次性验证多个移动场景from core import next_step cases [ { name: 正常前进, snake: [(5, 5), (4, 5), (3, 5)], direction: (1, 0), food: (6, 5), width: 10, height: 10, }, { name: 吃到食物, snake: [(5, 5), (4, 5), (3, 5)], direction: (1, 0), food: (6, 5), width: 10, height: 10, }, { name: 撞墙, snake: [(9, 5), (8, 5), (7, 5)], direction: (1, 0), food: (6, 5), width: 10, height: 10, }, ] for case in cases: result next_step( case[snake], case[direction], case[food], case[width], case[height], ) print(case[name], -, result)运行方式python batch_test.py执行后能看到三种结果正常移动、吃到食物、撞墙。你可以在测试脚本里增加断言把结果和预期做比对不匹配就抛异常。这种自动化验证会在你修改碰撞逻辑之后非常有用避免改了 A 功能破坏 B 功能。批量任务的概念也可以从这里扩展。比如你想对比“随机移动策略”和“简单贪婪策略”的存活时间可以写一个只调用next_step的模拟器循环执行几万次统计平均得分。这就是一个轻量批量模拟任务不需要打开任何游戏窗口运行效率会高很多。7.3 HTTP 接口要不要加除非你明确要做一个 Web 控制台版本否则不建议给贪吃蛇加 Flask 或 FastAPI。原因很简单pygame 的主循环和 Web 服务的请求循环要抢同一个线程处理不好会导致画面卡死或请求超时。更合理的做法是保持游戏本体是纯单机把计算逻辑放在core.py需要远程调用时再包一层 REST API并让core.py保持不依赖pygame的纯粹性。如果你确实想加 HTTP 接口注意接口只接收和返回坐标数据不直接操作游戏窗口。下面是一个通用思路具体实现需要按你自己的项目结构调整from flask import Flask, request, jsonify from core import next_step app Flask(__name__) app.route(/step, methods[POST]) def step(): data request.get_json() snake [tuple(item) for item in data[snake]] direction tuple(data[direction]) food tuple(data[food]) result next_step(snake, direction, food, data[width], data[height]) if result is None: return jsonify({dead: True}) new_snake, ate result return jsonify({snake: new_snake, ate: ate}) if __name__ __main__: app.run(host127.0.0.1, port5000)这段代码只做演示模板需要额外安装 flask 并调整数据结构不能直接复制就运行。我的建议是先把第一阶段的核心逻辑测试脚本做好等到项目确实有跨系统调用需求时再考虑引入 Flask。8. 资源占用与性能观察pygame 贪吃蛇本身是非常轻量的程序普通电脑跑起来几乎可以忽略资源占用。但“忽略”不等于不需要观察尤其在你要长时间挂机测试 AI 策略或把游戏嵌入其他应用时要关注四个指标CPU 占用、内存占用、帧率和窗口大小。先看帧率。程序里clock.tick(FPS)已经限制了游戏逻辑刷新频率FPS 10就是每秒刷新 10 帧。如果你把FPS改成 60画面会更流畅蛇的移动速度也会明显变快。这个数值是游戏难度的重要调节项但它也直接影响 CPU 占用帧率越高主循环每秒钟执行的逻辑和渲染次数越多。再看窗口大小。窗口大小由GRID_WIDTH、GRID_HEIGHT、CELL_SIZE共同决定。把CELL_SIZE从 20 调到 40视觉上格子变大实际绘制面积也变大渲染耗时会有提升。不过对 pygame 的二维矩形绘制来说这个差异在小窗口范围内并不明显。更需要注意的是高分辨率大网格比如GRID_WIDTH改成 100、GRID_HEIGHT改成 100每帧要遍历的蛇身坐标和要绘制的网格会增多资源占用才会有一个可感知的上涨。用系统自带工具观察资源占用最简单Windows 打开任务管理器看 Python 进程的 CPU 和内存。Linux 或 macOS 用top命令定位到python进程观察。也可以在代码里用time.perf_counter()打印每帧耗时判断瓶颈。import time prev_time time.perf_counter() # 主循环内的某一帧 now time.perf_counter() frame_time_ms (now - prev_time) * 1000 prev_time now if frame_time_ms 100: print(f帧耗时偏高: {frame_time_ms:.2f} ms)这张耗时打印可以帮助你判断是渲染慢、逻辑慢还是资源丢失造成卡顿。正常情况下小地图、10 到 15 FPS、单机运行的贪吃蛇不会出现持续高负载。如果出现明显 CPU 占用暴涨优先检查是不是开了多个 Python 进程比如之前有脚本没有正常退出进程残留在后台运行。对显存和 GPU 这类指标这个项目完全不涉及不需要看。真正决定性能的是 Python 解释器本身和 pygame 的渲染路径以及你的线程里有没有额外的高耗时任务。9. 常见问题与排查方法下面把贪吃蛇 pygame 项目里最容易踩的坑整理成一张表遇到问题先对照排查问题现象可能原因排查方式解决方案命令行提示python不是内部或外部命令Python 未加入 PATH执行python --version查看是否有输出重新安装 Python勾选 Add Python to PATH安装 pygame 报错pip 版本旧或网络源慢查看完整报错信息先执行python -m pip install --upgrade pip再使用国内镜像安装启动游戏后窗口一闪而过有语法错误或资源路径问题在命令行运行python main.py看控制台报错根据报错修改代码确保路径正确窗口能打开但蛇不动事件循环未正确监听方向键检查 KEYDOWN 分支是否写了正确的pygame.K_UP等常量确认键盘事件代码参考第 4 节主函数按相反方向蛇直接死亡缺少反向移动限制检查上下、左右方向互斥判断在方向更新时判断direction ! (0, 1)这类条件图片显示不出来资源路径不对或图片格式不支持看控制台是否有[WARN]信息把图片放到assets/images确保文件名一致音效播放没有声音系统音量、混音器初始化、wav 格式问题确认pygame.mixer.init()已执行文件存在重新初始化混音器或转换音效为常见 wav 编码吃食物后新食物生成在蛇身上随机坐标没有排除蛇身单元格查看get_random_food里的while循环判断pos not in snake否则继续随机生成游戏结束但进程没退出pygame.quit()没有执行或主循环未跳出看主循环是否还在等待事件在碰撞分支设置running False结束后调用sys.exit()打包成 exe 后找不到图片音效PyInstaller 打包时未包含资源文件检查 exe 同目录下是否有assets使用 PyInstaller 的--add-data参数并让代码使用相对路径最容易翻车的是资源路径问题。开发时运行python main.py当前工作目录是项目根目录但如果直接在别的目录执行脚本os.path.abspath(__file__)和BASE_DIR的相对路径设计就能避免找不到图片音效。打包 exe 时资源文件默认不在 exe 内部要在打包命令里显式包含或者把assets目录放在 exe 同目录下。还有一个隐蔽问题是 pygame 的事件循环卡死后窗口无法关闭。如果你在while running循环里做了耗时很长的操作比如访问网络或读取大文件事件响应会被延迟看起来就像窗口假死。处理方法是把耗时任务移到游戏主线程之外或者用状态机控制事件响应频率。10. 最佳实践与使用建议10.1 代码结构保持清晰不要把所有逻辑都堆进一个main.py。比较舒服的划分方式是main.py管理游戏入口和主循环core.py存放可测试的纯逻辑函数assets文件夹只放资源。这样代码可读性高也方便后续用脚本自动测试。哪怕是练手项目好的工程习惯也要尽早建立。10.2 第一次运行先小参数测试不要一上来就把网格调大、帧率调高。先用默认参数跑通再逐步调整CELL_SIZE、GRID_WIDTH、GRID_HEIGHT和FPS。每次只改一个参数观察效果和资源占用避免多个变量同时变化导致问题无法定位。10.3 资源目录和文件名要统一建议图片统一用 PNG 格式音效统一用 wav 格式。文件名全部用小写英文加下划线不要出现中文名和空格不然跨平台复制后容易出错。如果素材文件确实叫food.png代码里就不要用Food.png去加载。10.4 素材版权与合规图片和音效不要随意从商业游戏、付费素材站下载后直接打包分发。优先使用免费可商用的素材库或者自己用绘图工具和音频工具生成。涉及别人肖像、品牌元素的内容也要避免。公开分享源码包时在 README 里注明素材来源和授权协议这是对项目负责也是对自己负责。10.5 打包发布前做完整回归如果你要打包成 exe 交作业或分享打包前把所有功能重新测一遍方向控制、吃食物、音频播放、结束退出、资源加载。PyInstaller 是非常常用的打包工具安装命令python -m pip install pyinstaller打包指令示例pyinstaller -F -w main.py --add-data assets;assetsWindows 下--add-data的分隔符是分号Linux 和 macOS 下是冒号。这个命令不是每个项目都通用但作为基本模板可以先跑通再微调。打包后把 exe 放到一个新目录确认同目录下有assets文件夹再双击运行。10.6 给项目加 README 和基础注释README 里写三样东西就够了怎么安装、怎么运行、项目结构。代码注释不用每行都写重点注释方向限制、碰撞判定、资源加载这几个容易出问题的地方。这样两周后回来看代码你还能快速回忆起当时的设计思路。11. 总结与下一步这个项目的核心价值在于用少量代码把游戏程序的主循环讲清楚同时把图片加载、音效播放、碰撞判定、计分刷新这些常用能力全部练了一遍。你最先值得验证的功能是基础移动和吃食物增长只要这两条链路跑通整个项目就成功了一半。最容易踩的坑集中在反向移动限制、资源文件路径、打包时资源缺失遇到问题优先排查这三处。如果接下来想继续扩展方向很多可以给蛇写一个基于广度优先搜索的自动寻路 AI让它自己找食物可以把最高分保存到本地文件做排行榜可以增加暂停菜单、难度选择、墙壁模式和不同地图也可以把core.py里的逻辑函数继续抽细引入pytest做单元测试。从一个小游戏起步逐步把工程化能力补齐这是 Python 入门阶段很扎实的一条路。建议先把基础版代码保存好在main.py顶部把常量的注释写清楚然后把图片和音效素材按目录放好。运行成功后再去尝试加功能。这个项目适合反复改、反复玩每一次重构都会让你对 pygame 事件循环的理解更深一层。