使用PyInstaller打包含自定义模块的PyQt脚本后无GUI显示如何解决

你遇到的报错是两个核心原因导致的：

1. PyInstaller 默认只会扫描主脚本的显式导入路径，你项目内的自定义模块、导入时用了别名的模块（比如你代码里应该是import parser as dxfParser、import writer as msys_writer这类别名导入）无法被自动识别，会被判定为缺失模块
2. 打包GUI程序时没有加--windowed参数，会导致PyQt的界面渲染链路异常，出现不显示界面的问题

不需要自定义hooks，直接通过PyInstaller自带参数即可解决，你需要在项目根目录（也就是Converter文件夹内）打开终端，执行以下命令：

pyinstaller --onefile --windowed -p . --hidden-import msys_writer --hidden-import dxfParser --hidden-import mechanism converter_GUI.py

各参数作用说明：

• -p .：指定当前文件夹为模块搜索路径，让PyInstaller可以找到你项目内的所有自定义py文件
• --hidden-import xxx：手动声明PyInstaller未扫描到的缺失模块，对应你日志里报的三个找不到的模块
• --windowed：GUI程序专属参数，禁用控制台窗口，避免PyQt界面渲染异常
• --onefile：保留你需要的单文件打包逻辑

如果执行上述命令后仍有模块缺失报错，可以做以下操作：

1. 删除项目内已生成的build、dist文件夹和converter_GUI.spec文件，清除旧的打包缓存
2. 重新运行一次上述打包命令，生成新的spec文件后终止命令
3. 打开converter_GUI.spec文件，找到hiddenimports字段，把所有缺失的模块名添加到列表里，保存后执行pyinstaller converter_GUI.spec即可完成打包

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