如何将Pgzero（pygame zero）游戏导出为.exe可执行文件

第一步：调整游戏主文件 #

• 首先在你的游戏主脚本（例如命名为main.py）的最末尾添加两行代码，显式声明启动入口：

import pgzrun
pgzrun.go()

• 处理资源路径适配：pgzero默认从当前脚本目录加载images、sounds、music等资源文件夹，打包后exe的运行目录会变化，需要在脚本开头添加路径适配代码：

import os
import sys
# 适配单文件打包的临时资源路径
if getattr(sys, 'frozen', False):
    os.chdir(sys._MEIPASS)

如果你希望资源文件夹和exe放在同目录、方便后续修改替换资源，把上面的路径代码改成os.chdir(os.path.dirname(sys.executable))即可。
你之前使用的脚本是用于构建pgzero Python分发包的配置，作用不是生成exe可执行文件，所以得到.egg文件属于正常结果，无需再尝试该方案。

第二步：执行打包命令 #

使用如下pyinstaller命令进行打包，替换main.py为你的实际主脚本文件名：
pyinstaller -w -F --add-data "images/*;images/" --add-data "sounds/*;sounds/" --add-data "music/*;music/" --hidden-import pgzero --hidden-import pgzero.builtins --hidden-import pygame main.py

命令参数说明： #

• -w：打包为窗口程序，运行时不弹出黑框控制台，调试阶段可以先去掉这个参数，运行exe时就能看到具体报错信息
• -F：打包为单个exe文件
• --add-data：用来把你的资源文件夹打包到程序中，如果你有其他自定义资源目录，按相同格式追加即可
• --hidden-import：声明pyinstaller无法自动识别的pgzero依赖模块

常见问题排查 #

1. 打包过程报错：先确认你的pyinstaller、pgzero、pygame都是最新版本，执行pip install --upgrade pyinstaller pgzero pygame更新后重试
2. 打开exe报错找不到模块：在打包命令中追加对应缺失模块的--hidden-import 模块名参数即可
3. 打开后无响应：先去掉-w参数重新打包，运行exe看控制台输出的具体报错，90%的情况是资源路径配置错误导致找不到资源文件

内容的提问来源于stack exchange，提问作者Dielna Reboot