Pygame Zero安装配置与pgzrun游戏脚本运行示例

脚本专家

Pygame Zero 是面向 Python 3 的零配置游戏开发框架，建立在 Pygame 之上，内置 Actor、screen、sounds 等函数和类，适合用少量脚本快速验证 2D 游戏逻辑。下面按安装、项目结构、两个可运行示例和常见排查点整理。

一、环境检查和安装
Pygame Zero 依赖 Python 3.6 或更高版本。先在终端确认环境：

2. python --version
3. pip --version

复制代码

安装阶段先安装 Pygame：

2. pip install pygame

复制代码

然后安装 Pygame Zero：

2. pip install pgzero

复制代码

补充介绍指出，pip install pgzero 会自动装好 Pygame 等依赖，因此实际操作可以优先执行 pgzero 安装；若环境已有 Pygame，也可保留单独安装步骤。包名方面，pip install pgzero 和 pip install pygame-zero 指向同一个项目，推荐使用 pgzero。
安装完成后验证：

2. pgzrun --version

复制代码

能显示版本号说明安装成功。树莓派官方系统自 2015 年起默认预装 Pygame Zero，无需额外安装。

二、创建项目目录
新建一个文件夹，在文件夹中创建 Python 文件，例如 my_game.py。按补充介绍的资源目录约定：图片放在 images/，声音放在 sounds/，音乐放在 music/，Pygame Zero 会自动从这些目录加载资源。图片建议使用透明 PNG。原文步骤 3 的示例还要求 alien.png 与脚本同目录可用；如果采用目录规范，可准备 images/alien.png。

三、最小示例：用 screen.blit 显示图片

2. import pgzrun
4. def draw():
5.     screen.clear()
6.     screen.blit('alien', (100, 100))
8. pgzrun.go()

复制代码

这段代码通过 import pgzrun 引入运行环境，draw() 用于绘制，screen.clear() 清屏，screen.blit('alien', (100, 100)) 在坐标 (100,100) 绘制名为 alien 的资源，pgzrun.go() 启动游戏。准备 alien.png 后，在命令行进入项目目录运行：

2. python my_game.py

复制代码

原文步骤 4 使用上述命令；补充介绍也给出 pgzrun my_game.py 作为运行入口。代码正确且资源可用时，会启动窗口并显示图片。

四、Actor 示例：让外星人移动

2. WIDTH = 800
3. HEIGHT = 600
4. alien = Actor('alien')
5. alien.pos = 100, 100
7. def draw():
8.     screen.clear()
9.     alien.draw()
11. def update():
12.     alien.x += 1
13.     if alien.left > WIDTH:
14.         alien.right = 0

复制代码

这里 WIDTH 和 HEIGHT 设置 800x600 的窗口；Actor('alien') 根据 alien 资源创建角色，alien.pos = 100, 100 设置初始坐标。draw() 中清屏并调用 alien.draw() 绘制角色；update() 中执行 alien.x += 1，让角色向右移动。当 alien.left > WIDTH 时，把 alien.right 设为 0，使角色从左侧重新出现。运行：

2. pgzrun my_game.py

复制代码

如果看到外星人从左往右移动，说明安装、代码和资源路径正常。按 Ctrl-Q 退出游戏。

五、常见问题与兼容性
1. 版本不满足：确认 Python 3.6 或更高，可用 python --version 检查。
2. 安装验证失败：检查 pip --version，重新执行 pip install pgzero，并用 pgzrun --version 确认。
3. 资源加载失败：检查图片是否放在 images/ 目录，或按原文最小示例放在脚本同目录；名称与代码中的 'alien' 对应。
4. 包名混淆：pgzero 和 pygame-zero 是同一项目，推荐 pip install pgzero。
5. 树莓派环境：官方系统已默认预装，通常不需要再安装。

Pygame Zero 的价值在于把 Pygame 的事件循环、绘制和资源加载做了封装，用 Python 脚本就能快速搭建 2D 游戏原型。掌握 WIDTH/HEIGHT、Actor、draw()、update()、screen.clear()、alien.draw() 和 pgzrun 命令后，就可以按同一结构扩展自己的小游戏。