PyInstaller打包后闪退主因是异常未捕获且--windowed屏蔽错误输出，应加--console查看报错；资源路径需用sys._MEIPASS动态获取；Qt程序需确保platforms插件完整并设置QT_QPA_PLATFORM_PLUGIN_PATH。
PyInstaller 打包后双击闪退，怎么查原因
根本原因是没捕获启动时的异常，exe 默认不显示控制台，错误直接消失。最有效的办法是加 --console 参数重新打包，让窗口弹出来，就能看到报错信息了。
- 常见错误现象：
ModuleNotFoundError: No module named 'xxx'—— 多半是隐式导入没被自动识别（比如用字符串动态 import 的模块） - 如果用了
tkinter、matplotlib或PyQt5，得确认是否带了对应 hook（PyInstaller 一般自带，但旧版本可能漏） - 打包命令建议加
--onefile --console --name myapp，先确保能跑通再关掉 console - 调试阶段别用
--windowed，它会屏蔽 stdout/stderr，等于自断线索
资源文件（图片/配置/数据）找不到路径怎么办
打包后所有资源不再在脚本同目录，而是解压到临时文件夹（sys._MEIPASS），硬写相对路径必失败。
- 必须用运行时逻辑判断路径：
getattr(sys, '_MEIPASS', os.path.dirname(os.path.abspath(__file__))) - 典型用法：读取图标或 JSON 配置时，先拼出完整路径：
os.path.join(resource_path(), 'config.json') - PyInstaller 不会自动包含子目录里的非 Python 文件，要用
--add-data "data;data"（Windows 分号，macOS/Linux 用冒号）显式声明 - 注意
--add-data的路径是「源路径;目标路径」，目标路径是 exe 解压后内部的虚拟路径，不是你硬盘上的位置
打包体积太大，怎么精简
PyInstaller 默认把整个 Python 环境和所有依赖都塞进去，尤其带 numpy、pandas 或 GUI 框架时，动辄百 MB。关键在排除无用模块和禁用冗余功能。
- 用
--exclude-module干掉确定不用的包，比如matplotlib用户如果只画图不存图，可排除matplotlib.backends.backend_tkagg等后端 - GUI 程序若没用多线程，加
--noconsole后再加--strip（Linux/macOS 有效，Windows 需 MinGW 工具链） - 避免用 conda 环境打包 —— conda 安装的包往往带调试符号和测试模块，pip + venv 更干净
- 检查
spec文件里的excludes和datas，比命令行参数更可控；改完用pyinstaller myapp.spec重打
PyQt5/PySide2 程序打包后界面空白或报 DLL 错误
这类框架依赖大量 Qt 动态库和插件（如 platforms/qwindows.dll），PyInstaller 有时漏拷贝，或者系统环境变量干扰了插件加载路径。
立即学习“Python免费学习笔记（深入）”；
- 必须确认 PyInstaller 版本 ≥ 4.5（旧版对 Qt6 支持差），且使用与开发环境一致的 PyQt5/PySide2 小版本
- 打包后进
dist/myapp/目录，检查是否存在platforms/子目录，以及里面有没有qwindows.dll（Windows）或libqcocoa.dylib（macOS） - 如果缺失，手动复制 Qt 安装目录下的
plugins/platforms/到dist/myapp/，或用--add-binary命令绑定 - 启动时加环境变量修复路径：
os.environ['QT_QPA_PLATFORM_PLUGIN_PATH'] = os.path.join(sys._MEIPASS, 'platforms')，放在主窗口创建前
