咨询PyInstaller打包EEL人脸识别项目为exe的实现与调试方法
PyInstaller 打包 EEL 人脸识别项目问题解决
资源文件打包规则
- PyInstaller 打包非Python类资源时,需要通过
--add-data命令参数完成资源映射,Windows环境下格式为--add-data "源资源路径;程序内解压目标路径",逐一把项目依赖的文件夹、单文件添加到打包配置中。 - 对应你当前项目需要配置的映射项:
- EEL 前端资源目录:代码中
eel.init('assets')指向的assets文件夹,对应映射规则--add-data "assets;assets" - 音效文件目录:将存储音效的关联文件夹按照「原文件夹名; 同名称解压路径」的格式添加,保证程序内相对路径匹配
- 其他业务关联文件夹:人脸数据集存储目录、预训练模型文件目录、考勤相关目录等,全部按照相同格式添加
- 单类资源文件:代码中调用的
Attendance Report.xlsx文件,对应映射规则--add-data "Attendance Report.xlsx;.",代表解压到程序运行的根目录
- EEL 前端资源目录:代码中
- 路径兼容适配:PyInstaller 打包后运行时,所有资源会解压到系统临时的
_MEIxxxxxx临时路径下,直接用代码内硬编码的相对路径会出现找不到文件的报错。需要在主代码开头添加统一的资源路径获取逻辑:
再把代码中所有涉及资源调用的路径替换为该函数的返回值,比如把def get_resource_path(relative_path): try: base_path = sys._MEIPASS except Exception: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path)eel.init('assets')修改为eel.init(get_resource_path('assets')),把os.startfile('Attendance Report.xlsx')修改为os.startfile(get_resource_path('Attendance Report.xlsx'))。 - 自定义关联Python模块:
dataset_capture2、train_dataset_new、offline_records这类你自己写的业务脚本,PyInstaller 会自动扫描import依赖打包,不需要手动添加,但要注意这些模块内部引用的资源文件,同样要按照上面的规则配置资源映射。 - 参考打包命令(Windows环境):
注意:调试阶段不要加pyinstaller --noconfirm --name FaceAttendance --add-data "assets;assets" --add-data "你的音效文件夹;你的音效文件夹" --add-data "Attendance Report.xlsx;." 你的主脚本文件名.py--windowed参数,保留控制台窗口输出,待问题全部排查完成后再添加该参数生成无控制台的正式版本。
exe 闪退无法查看报错的解决方法
- 打开系统cmd命令提示符窗口,直接把dist目录下生成的exe文件拖拽进cmd窗口,按回车运行,所有报错堆栈会直接打印在cmd窗口中,程序退出后窗口不会自动关闭,可以完整读取报错内容。
- 打包时不添加
--windowed参数,保留控制台模式生成exe,运行时控制台窗口会和程序同步存在,所有print输出、程序报错都会实时显示,不会出现窗口秒关的问题。 - 可在主程序入口添加全局异常捕获逻辑,把所有报错内容写入本地日志文件,即使程序闪退也能事后排查:
import traceback if __name__ == "__main__": try: # 原有全部业务代码 eel.start('/index.html') except Exception: with open("error_log.txt", "w", encoding="utf-8") as f: f.write(traceback.format_exc()) - 排查原有代码中
os.system("pause")的逻辑:这两行暂停命令只有在cmd直接运行python脚本时才会生效,双击exe运行时没有对应的终端上下文,不会起到暂停窗口的作用,调试完成后可以直接删除。
内容的提问来源于stack exchange,提问作者sharan deepak
相关产品推荐
相关产品推荐

