Pygame 入门:从安装到第一个游戏
本教程带你搭建 Python 环境、安装并验证 Pygame,逐步完成窗口、角色移动、事件处理、碰撞检测与计分,最终制作一个可运行的小游戏。
- 1
安装 Python 与 Pygame
前往 python.org 下载 Python 3,安装时勾选 Add Python to PATH;打开终端输入 python -m pip install pygame,安装 pygame-ce 也可。
- 2
验证运行环境
在终端输入 python -c "import pygame; print(pygame.version.ver)"。若输出版本号,说明安装成功;随后新建 main.py 文件。
- 3
创建游戏窗口
导入 pygame 并调用初始化函数,设置 800×600 窗口和标题,使用 while 循环持续处理退出事件,并在每帧填充背景色。
- 4
绘制并移动角色
加载图片并转换为 Surface,在循环中读取按键状态更新坐标,使用 blit 绘制角色,再用 clock.tick(60) 将帧率限制为每秒60帧。
- 5
加入敌人与碰撞
创建随机下落的敌人矩形,每帧更新位置并检测 rect 碰撞。发生碰撞时减少生命值或结束游戏,并绘制生命和分数文字。
- 6
完善计分与启动方式
加入字体、计分和重新开始逻辑,保存为 main.py;运行 python main.py 测试移动、碰撞、暂停和退出功能。
💡 实用技巧
- 每个事件都应处理 pygame.quit
- 先画背景再绘制角色和文字
- 用 dt 缩放速度以适配帧率
- 对象较多时优先使用精灵系统
- 图片加载后立即调用 convert
⚠️ 常见坑
- 窗口只闪现通常是主循环未持续运行
- 忘记初始化字体或音频模块会报错
- 输入中文路径可能影响旧版资源加载
- 循环内频繁加载图片会拖慢性能
常见问题
Q:安装后怎么确认 Pygame 能正常使用?
打开终端输入 python -c "import pygame; print(pygame.version.ver)",如果输出版本号,就说明 Python 已正确找到并加载 Pygame。随后可将游戏代码保存为 main.py,用 python main.py 运行。
Q:窗口只闪一下就消失该怎么排查?
检查主循环是否使用 while 持续运行,并在循环中处理 pygame.QUIT 事件。每帧先填充背景,再绘制角色和文字;使用 clock.tick(60) 控制循环速度,退出时调用 pygame.quit()。
Q:素材加载报错或游戏运行卡顿怎么办?
把图片放在 main.py 同级目录,使用相对路径加载,避免包含中文的路径;加载后立即调用 convert() 转换 Surface。不要在游戏循环内反复加载图片,应在循环外统一加载并复用。