简介这是一套汇集二十个经典小游戏的 Python pygame 源码合集所有游戏均亲测可正常运行面向 Python 初学者、游戏开发入门者以及课堂教学场景推荐使用 PyCharm 打开运行。游戏类型十分丰富涵盖射击达人、动物对决、迷宫、打地鼠、2048、贪吃蛇、扫雷、滑雪、飞翔的小鸟、塔防、坦克大战、吃金币、飞机大战、外星人入侵、吃豆人、守护花朵、连连看、计算器、弹球等多个经典玩法从休闲益智到动作闯关均有涉及。资源包内共 2000 个文件压缩后约 165.68MB除 Python 源码和编译文件外还包含大量图片、动图、音效、字体、地图以及说明文档、配置文件且目录按游戏模块组织便于查找与二次开发。已有 1298 人学习下载适合用来研究 pygame 的事件循环、碰撞检测、动画更新、计分系统与游戏状态管理等核心机制上手即可运行并拓展。1. 20 个 pygame 小游戏源码包先跑起来再谈好不好用拿到这套 pygame 小游戏源码包我做的第一件事不是看代码而是把 20 个游戏全部启动一遍。20 个独立目录亲测能正常跑起来——这个前提比功能介绍值钱因为 pygame 项目最常见的死法是环境没配对窗口一闪而过让人误以为代码是坏的。适合刚学完 Python 基础、想在 pygame 里找手感的新手也适合要快速落地课程设计的在校生。包里大多是贪吃蛇、俄罗斯方块、飞机大战这类经典玩法也夹着五子棋、打砖块等轻量项目。每个游戏独立目录入口和素材分开结构高度一致读懂一个剩下 19 个就能顺同一套路拆。下文按我复现的顺序写搭环境、拆源码、列坑、改造。2. 环境与启动Python 版本、虚拟环境与 PyCharm 三件事这套 20 个 pygame 小游戏能不能跑起来关键不在代码而在环境。源码包里所有游戏只依赖 pygame 一个第三方库没有任何需要联网的模块环境搭对之后启动就是一条命令的事。我按推荐顺序来先定 Python 版本再建虚拟环境最后找入口脚本。无论你用 PyCharm 还是 vscode虚拟环境这条路完全一样下文命令通用。2.1 先把 Python 版本钉在 3.8 到 3.11pygame 底层封装的是 SDL 库SDL 对不同 Python 版本的支持节奏有差异。网上流转的免费 python 源码包里老项目十有八九是用 Python 3.7 或 3.8 写的函数命名和代码风格都很老派。用新版本 Python 去跑多数时候能兼容但偶尔会遇到pygame.mixer初始化失败或者pygame.surfarray报错这类硬问题定位起来非常费时间。我一般会把项目解释器直接选成 Python 3.8 到 3.11 之间的版本搭配 pygame 2.1 之后的版本。这套 20 个小游戏用的全是标准 API比如display.set_mode、event.get、image.load、mixer.Sound这些从 2.1 到 2.5 接口基本没变兼容面很宽。下面这张表是我常用的版本判断参考Python 版本建议 pygame 版本备注3.8 – 3.102.1.x – 2.5.x最稳妥老代码基本不用改3.112.3 以上注意 mixer 声音初始化3.12 – 3.132.5.2 以上或 pygame-ce老工程可能需要小改这里有个容易混的点pygame-ce是社区维护的分支接口上兼容 pygame但对新 Python 的支持更积极。如果你电脑上只有 Python 3.13 又不想换版本装 pygame-ce 是更现实的选择但注意一个项目里不要同时出现 pygame 和 pygame-ce 的混装痕迹否则 import 出的模块可能不是你预期的那一套。如果你还没装 Python先装 3.10 或 3.11安装向导里记得勾选 Add Python to PATH。装完在系统终端执行python --version确认版本PATH 没配好是 python 安装教程里最高频的问题表现就是输入 python 提示不是内部或外部命令。2.2 PyCharm 中创建虚拟环境并安装 pygame虚拟环境的作用不只是隔离依赖更重要的是让排查路径变短。这套源码包下载到本地后我建议放在一个不带中文路径的目录下比如D:\projects\pygame_games再在这个目录里建虚拟环境避免路径编码问题牵连到素材加载。PyCharm 新建项目时可以直接选 Virtualenv 作为解释器类型如果项目已经存在进 File Settings Project Python Interpreter点齿轮选 Add Interpreter同样能切到 venv。解释器切好之后打开 PyCharm 自带的 Terminal依次执行python -m venv venv source venv/bin/activate # Windows 下执行 venv\Scripts\activate python -m pip install --upgrade pip pip install pygame2.5.2 python -c import pygame; print(pygame.version.ver)最后一行输出类似2.5.2的版本号就说明安装成功。这里有三个细节值得较真第一activate 只改变当前终端的 PATH如果你又在 PyCharm 的 Python Packages 面板里手动装了一次 pygame两个位置可能不一致运行时以终端导入结果为准第二如果源码包根目录有requirements.txt直接pip install -r requirements.txt更省事没有就只装 pygame因为 20 个游戏没有其他第三方依赖第三装完验证时不要新开一个系统终端必须在同一个激活了 venv 的终端里验证否则很容易误判成安装失败。如果安装速度很慢换国内镜像源是常见做法pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pygame2.5.2。这不会改变包的内容只是下载通道不一样。注意venv 目录不要放在带空格的路径里某些 pygame 素材加载对路径空格很敏感。2.3 找到入口脚本并启动第一个游戏依赖装好之后先别急着改代码。打开源码包根目录常见的组织方式是每个游戏一个文件夹文件夹里放入口脚本和素材子目录。入口脚本最常见的名字是main.py也有叫run.py、game.py的个别包会把入口写在start.py里。我的习惯是先把整个目录结构扫一遍记录每个游戏的入口文件名后面做统一管理时用得上。启动第一个游戏命令很直接cd 01_snake # 换成你本机实际存在的游戏目录名 python main.py窗口弹出来、能看到游戏画面说明环境全部打通。如果弹出后立刻闪退不要反复双击先看终端里的报错十有八九是这三类找不到素材文件、pygame 初始化失败、入口脚本里直接抛了异常。如果终端提示 python 不是内部或外部命令说明解释器没进 PATH回到 2.1 把 PATH 配上如果提示目录不存在先ls或dir看一下真实目录名我见过资源包里的目录名带了版本号后缀和 README 写的对不上。提前打个预防针窗口出现但画面卡死大概率是主循环里没有clock.tick这个到第三章拆源码时会看到具体写法。另外跑第一个游戏之前我习惯看一眼入口脚本末尾有没有if __name__ __main__:保护。有这个保护说明作者考虑过模块化导入后面改造成统一启动器时几乎不用动结构没有这个保护游戏一 import 就会直接开窗口改造时要手动包一层函数。这个细节在第五章会派上用场。3. 拆源码pygame 主循环、事件机制与贪吃蛇的实现把这 20 个游戏挨个打开会发现所有代码都围着同一个主循环转。这个循环可以浓缩成四步初始化窗口和时钟、收取事件、更新游戏状态、绘制画面。几乎每个 pygame 小游戏都是这个套路区别只在更新和绘制两步里做了什么。3.1 pygame 项目的基本骨架初始化、事件、更新、绘制下面这段是我在很多 pygame 源码里都见过的最小骨架这 20 个游戏基本都能对上号import pygame pygame.init() screen pygame.display.set_mode((800, 600)) pygame.display.set_caption(pygame 小游戏) clock pygame.time.Clock() running True while running: for event in pygame.event.get(): if event.type pygame.QUIT: running False elif event.type pygame.KEYDOWN and event.key pygame.K_ESCAPE: running False # 更新游戏状态位置、碰撞、分数 # 绘制画面 screen.fill((0, 0, 0)) pygame.display.flip() clock.tick(60) pygame.quit()逐个拆开看pygame.init()负责初始化所有模块包括显示、声音、字体少量游戏会在 init 之前单独调pygame.mixer.pre_init设置音频参数set_mode返回一个 Surface后续所有绘制都画在这块画布上event.get()必须放在循环里每帧调用否则窗口的关闭事件排不上队点关闭按钮没反应flip()把画布真正推到屏幕上不调用它画面就只存在于内存里clock.tick(60)把帧率锁在 60同时决定了游戏的整体速度。判断一个 pygame 项目写得规不规范先看这四个位置就行。3.2 以贪吃蛇为例网格坐标、方向状态与碰撞判定20 个游戏里最适合从头读的是贪吃蛇。它逻辑简单但又覆盖了 pygame 游戏核心的三个概念位置表示、输入处理、碰撞判定。常见实现里蛇身是一个坐标点列表方向用一个向量表示每帧把新头部插入列表头部没吃到食物就删掉尾部这就是移动的本质。核心移动逻辑大概是下面这样snake [(10, 10), (9, 10), (8, 10)] # 蛇身列表头部在第一位 direction (1, 0) # 每帧向右移动一格 def move(snake, direction, food): head snake[0] new_head (head[0] direction[0], head[1] direction[1]) snake.insert(0, new_head) if new_head food: return True # 吃到食物蛇变长不删尾部 snake.pop() # 没吃到删尾部蛇保持原长 return False两个容易被忽略的细节一是方向向量取值只有 (1,0)、(-1,0)、(0,1)、(0,-1) 四种按键处理时不能允许反向否则蛇头直接撞进自己身体二是吃到食物的判断放在插入之后蛇头占住食物那一格视觉上就是咬住食物。碰撞判定更简单新头部出界或者出现在蛇身列表里游戏结束。食物坐标一般用random.randrange在网格里取生成时还要避开蛇身占用的格子否则食物刷在蛇身上玩家根本点不到。分数则是每次move返回 True 时加一分。20 个游戏里但凡带蛇字或贪吃字样的核心基本都是这套结构剩下的只是画面和音效包装不同。3.3 素材加载与路径问题为什么在 PyCharm 里能跑、双击就崩20 个游戏里有不少用了图片和音效素材加载的稳妥写法是下面这种import pygame import os BASE_DIR os.path.dirname(os.path.abspath(__file__)) image pygame.image.load(os.path.join(BASE_DIR, assets, snake_head.png)) sound pygame.mixer.Sound(os.path.join(BASE_DIR, assets, eat.wav))注意pygame.image.load用相对路径时是相对于进程的工作目录不是脚本所在目录。这里的关键就在上面这句提示。你在 PyCharm 里点绿色三角运行PyCharm 会把工作目录设置成项目根目录素材相对路径因此成立但如果你在终端里切到别的目录执行python 01_snake/main.py相对路径就断了表现是 FileNotFoundError或者窗口打开后图片全是黑块、画面不渲染。这也是我一直强调从源码包根目录启动的原因把工作目录这个变量从一开始钉死。还有一个连带问题如果游戏里用pygame.font.Font渲染中文文字而系统字体路径指向中文字体文件换到没有对应字体的机器上会变方块。拿到新源码包时全局搜一遍image.load和mixer.Sound把这两行的路径逻辑确认清楚能省掉后面一大半的排错时间。4. 避坑与排查pygame 小游戏最常见的 5 个翻车现场下面 5 个坑几乎都和代码逻辑无关而是环境和运行方式的问题。每条按现象、原因、解决三步拆都是我在跑这套 20 个游戏过程中实际遇到过的。4.1 黑窗口一闪而过完全看不到报错现象双击入口脚本或直接运行窗口弹出一瞬间就消失终端也一起关闭什么信息都没留下。原因两种情况最常见。第一种是脚本执行时抛了异常Windows 上双击运行时终端随进程一起关闭报错被吞掉第二种是代码里写了pygame.quit()或sys.exit()提前触发退出常见于作者调试后遗留的语句。解决不要在资源管理器里双击改用 PyCharm 的 Run 按钮异常会打印在 Run 面板里。如果必须双击运行在入口脚本末尾临时加一行input(按回车退出)让窗口停在报错现场。看到具体异常之后再决定是改环境还是改代码盲目重装 pygame 是最浪费时间的第一步。4.2 ModuleNotFoundError: No module named pygame现象终端执行python main.py提示找不到 pygame 模块但明明刚装过。原因当前终端用的 Python 解释器不是装 pygame 的那一个。最常见是 activate 失败后还在系统 Python 里执行或者 PyCharm 项目解释器还是旧的。我见过最隐蔽的是电脑里同时装了 Python 3.8 和 3.10pip 装到了 3.8终端默认却用 3.10。解决先执行python --version确认解释器路径再用python -m pip install pygame2.5.2重装注意用python -m pip而不是裸pip这样安装目标和运行目标一定是同一个。装完用python -c import pygame; print(pygame.version.ver)验证。PyCharm 用户在 Settings 里检查 Project Interpreter 是否指向 venv。4.3 游戏能开窗但声音模块报错或直接没声音现象窗口正常终端报pygame.error: audio device not initialized或者 Linux 下报 ALSA 相关错误有的游戏不开声音能跑但一调用mixer.Sound.play()就崩。原因SDL 音频子系统初始化依赖系统声卡驱动pygame 的 mixer 初始化一直是有点玄学的部分。Windows 下常见老代码用pygame.mixer.pre_init(44100, -16, 2, 512)设置了当前声卡不支持的参数Linux 下常见于无桌面环境或远程机器没有声卡。解决不改源码的前提下在pygame.init()之前插入一行pygame.mixer.pre_init(44100, -16, 2, 512)很多参数不匹配的问题会在初始化阶段暴露而不是运行时崩溃。如果还是没声音把pygame.mixer.init()包进 try/except异常就跳过音频继续跑这是止损最快的方案毕竟看小游戏代码时声音不是第一优先级。4.4 游戏速度像开了倍速或者卡成幻灯片现象蛇跑得飞快一帧走好几格反过来某些动画卡顿操作明显有延迟。原因前者是主循环里没有clock.tick(fps)pygame 默认不限制帧率循环转多快游戏就多快帧率能冲到几百后者是 tick 设置太低或者循环体里有每帧重复的耗时操作比如每帧都重新加载图片。解决在主循环末尾加clock pygame.time.Clock()并调用clock.tick(60)把帧率钉在 60。如果速度还是不对就把 tick 里数字调大调小试试这是 pygame 调游戏速度最直接的手段。比如蛇原本每帧移动一格tick(60) 下就是每秒 60 格想调慢就改成 tick(30)。另外养成一个习惯所有图片、字体、声音的加载都放到循环外的初始化段循环里只做 blit 和翻转帧率会稳定很多。4.5 图片或音效文件找不到报 FileNotFoundError现象报错指向assets/xxx.png找不到但打开资源管理器文件明明就在那里。原因工作目录和素材相对路径对不上。这个坑在第三章 3.3 说过本质是pygame.image.load用相对路径定位文件而相对路径是相对于进程工作目录不是脚本所在目录。解决优先从源码包根目录运行更稳的做法是把素材加载改成基于__file__的绝对路径改完之后目录结构怎么挪都不再触发这个错。我每次拿新源码包会先全局搜一遍image.load和mixer.Sound把路径确认完才跑游戏这一步可以说是最省时间的预防措施。最后补一个自检命令换电脑、换解释器之后先跑一遍再碰代码python -c import sys, pygame; print(sys.version); print(pygame.version.ver); pygame.init(); print(pygame init ok)正常输出是 Python 版本、pygame 版本、pygame init ok三行。拆开看sys.version打印解释器版本pygame.version.ver打印库版本pygame.init()验证底层 SDL 能不能在当前机器完成显示和音频初始化。如果 init 这一步就抛错说明 SDL 底层资源有问题按 4.1 的方法看完整报错。这个命令把解释器对不对、库装没装、底层库能不能初始化三件事一次验完。5. 进阶玩法给 20 个游戏套一个统一启动器20 个游戏每个单独跑没问题但逐个点入口脚本很烦。我拿到这套资源后做的第一件事是写一个 pygame 菜单启动器把 20 个小游戏收进同一个窗口。改造前先确认两个前提入口脚本有if __name__ __main__:保护且每个游戏能暴露一个统一的入口函数比如main()。缺保护的游戏import 进去就会直接开窗口必须先包一层函数。方案是用 importlib 从文件路径加载模块而不是硬编码 import因为目录名带01_这种序号前缀不能直接当模块名用import importlib.util import os def load_game(folder): path os.path.join(games, folder, main.py) # folder 形如 01_snake spec importlib.util.spec_from_file_location(folder, path) mod importlib.util.module_from_spec(spec) spec.loader.exec_module(mod) return mod def launch(folder): game load_game(folder) if hasattr(game, main): game.main() else: print(f{folder} 没有 main() 入口跳过)用文件路径加载时模块的__name__是传入的 folder 名不是__main__入口脚本里那层 if 保护会跳过。所以真正要调用的是游戏暴露出来的main()函数hasattr检查是防止个别游戏入口函数名不统一直接报错中断菜单。这里最关键的设计是菜单主循环和游戏主循环不要嵌套。选中游戏后先退出菜单循环再进入游戏循环游戏退出后再回到菜单循环否则两个窗口交替初始化SDL 的显示上下文会打架表现就是画面闪烁甚至黑屏。从那以后我每拿到一套 pygame 源码包都强制自己按三条走一遍先搭环境跑通原版再拆入口脚本确认模块化程度最后才动代码做改造。这套流程帮我避开了绝大部分看起来是代码问题、其实全是环境问题的坑。希望帮到你。本文还有配套的精品资源点击获取