PyInstaller打包失败主因是静态分析无法识别隐式导入，需用--hidden-import补全；闪退因--windowed隐藏控制台，应先加--console调试；体积大属正常，可用虚拟环境、--exclude-module和UPX优化；跨平台需分平台打包并处理图标、签名及系统依赖。
PyInstaller 打包失败：找不到模块或 ImportError 怎么办
根本原因通常是 PyInstaller 没扫描到隐式导入（比如用 importlib.import_module 动态加载的模块，或某些科学计算库的 C 扩展依赖）。它不会执行你的代码，只做静态分析。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
--hidden-import显式补全，例如：pyinstaller --hidden-import=pandas._libs.skiplist main.py - 检查报错里具体缺哪个模块名，直接搜该模块的
__init__.py或文档，看是否需额外 import；常见如matplotlib要加--hidden-import=matplotlib.backends.backend_tkagg - 避免在代码里用字符串拼接模块名再
import，PyInstaller 看不见这种写法 - 临时加
--collect-all快速兜底（仅调试用），例如：--collect-all requests，但会增大体积，别上线用
打包后 exe 运行闪退：没日志、没报错、双击就消失
这是 Windows 下最典型的“没捕获异常 + 控制台被隐藏”组合问题。PyInstaller 默认用 --windowed（即无控制台），所有 print 和异常都丢进黑盒。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 先加
--console重新打包，双击运行看终端输出——绝大多数闪退都能立刻定位到哪行报错 - 如果确定要隐藏控制台，务必在主入口加异常捕获并写日志，例如在
if __name__ == "__main__":外层包一层try...except，把 traceback 写入error.log - 注意路径问题：打包后
__file__指向临时解压目录，读取同级资源文件要用sys._MEIPASS，例如：os.path.join(sys._MEIPASS, "config.json") - 不要依赖当前工作目录（
os.getcwd()），它可能是用户双击的桌面路径，不是 exe 所在目录
打包体积太大：一个空脚本打出 50MB+ 是正常吗
正常，但可大幅压缩。PyInstaller 默认把整个 Python 解释器 + site-packages 全打进去，哪怕你只用了 json 模块。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用虚拟环境隔离依赖：
python -m venv myenv && myenv\Scripts\pip install requests，再在这个环境里运行 PyInstaller，避免污染全局包 - 删掉不用的 hook：检查
venv\Lib\site-packages\PyInstaller\hooks下的hook-*.py，禁用明显无关的（如你没用 PyQt，就删掉hook-PyQt5.py） - 加
--exclude-module排除大而不用的包，例如：--exclude-module=tkinter --exclude-module=unittest - 用 UPX 压缩（需单独安装）：
pyinstaller --upx=True main.py，对 .pyd/.dll 有效，但某些杀软会误报，生产环境慎用
Mac / Windows / Linux 三端打包参数差异和兼容性坑
PyInstaller 不跨平台：Windows 打的 exe 在 Mac 上完全不能用，反之亦然。而且图标、权限、依赖路径规则各不相同。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 图标只在对应平台生效：
--icon=app.ico（Windows）、--icon=app.icns（macOS），Linux 不支持图标嵌入 - macOS 上必须用
--codesign-identity签名才能运行（否则 Gatekeeper 拦截），且需要开发者账号；M1/M2 芯片还需确认 Python 和 PyInstaller 都是 arm64 架构 - Linux 打包后可能缺系统级依赖（如
libglib-2.0.so.0），用ldd dist/main/main | grep "not found"查漏，再用--add-binary手动带入 - 别指望一次写完命令三端通用，每个平台单独维护一个打包脚本更可靠
最常被忽略的是资源文件路径处理和异常捕获机制——这两项不提前验证，上线后用户遇到问题你根本收不到任何线索。动态导入、多进程、C 扩展模块这三类场景，PyInstaller 的默认行为几乎总是不够用，得手动干预。
