PyInstaller打包报ModuleNotFoundError是因动态导入导致的隐藏依赖未被识别，需用--hidden-import显式声明、编写hook文件或代码中添加假导入来解决。
PyInstaller 打包时报 ModuleNotFoundError，但代码里明明没显式 import
这是最典型的“隐藏导入”问题：你的代码没直接 import 某个模块，但依赖的第三方库（比如 openpyxl、matplotlib、sqlalchemy）在运行时通过字符串动态导入，PyInstaller 静态分析无法捕获。打包后一运行就报错，比如：ModuleNotFoundError: No module named 'et_xmlfile'（openpyxl 依赖）或 No module named 'PIL._tkinter_finder'（Pillow + Tkinter 场景）。
解决思路不是“猜缺啥”，而是让 PyInstaller 知道它该带哪些它自己没发现的模块：
- 用
--hidden-import显式声明，例如：pyinstaller --hidden-import=et_xmlfile main.py - 对已知易出问题的库，优先查其官方文档或 PyInstaller 兼容列表——
openpyxl要加et_xmlfile和jdcal；gevent常需--hidden-import=gevent.monkey - 避免逐个试错：先用
--debug=all运行打包后的 exe，观察控制台输出中第一个缺失模块，补上再试；反复直到启动成功
用 hook 文件精准控制第三方库的导入行为
当某个库有大量隐藏导入、资源文件或需要修改 sys.path 时，--hidden-import 就不够用了。PyInstaller 的 hook 文件才是标准解法——它本质是 Python 脚本，告诉 PyInstaller “这个库到底要打包哪些东西”。
实操步骤：
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 找到 PyInstaller 的 hooks 目录：
python -c "import PyInstaller; print(PyInstaller.__path__[0])"，进入hooks子目录 - 新建
hook-xxx.py（xxx是你要处理的包名，如hook-openpyxl.py） - 在文件里调用
hiddenimports = ['et_xmlfile', 'jdcal']，或更完整地用collect_all('et_xmlfile')收集模块+数据文件 - 把 hook 文件放回原 hooks 目录，或通过
--additional-hooks-dir=.指定自定义路径
注意：不要直接改 PyInstaller 自带的 hooks（升级会覆盖），优先用 --additional-hooks-dir 管理自己的 hook。
运行时动态导入字符串模块，PyInstaller 无法静态分析
如果你的代码里有类似 __import__(module_name)、importlib.import_module(config.module) 或框架（如 celery、pluggy）按配置加载插件，PyInstaller 根本不知道具体会导入什么。这类情况不能靠猜，必须主动声明。
推荐做法：
- 在代码中显式预留“假导入”，仅用于打包识别（运行时不会执行）：
if False: import et_xmlfile import jdcal import PIL._tkinter_finder - 或统一在入口文件顶部集中写：
import pkgutil; [pkgutil.find_loader(x) for x in ['et_xmlfile', 'jdcal']]—— 强制触发导入检测 - 更健壮的方式是结合
AnalysisAPI 自定义打包逻辑，但门槛高，普通项目够用的场景极少
打包后 exe 启动闪退，但没报错信息
这往往是因为缺失隐藏模块导致进程在初始化阶段崩溃，连错误提示都来不及打印。别急着重打，先让 exe 输出日志：
- 运行时加
--console（Windows 下强制弹出命令行窗口），或打包时用--console而非--windowed - 若仍无输出，改用重定向：
your_app.exe > log.txt 2>&1，查看log.txt中真实的ImportError或ModuleNotFoundError - 特别注意 Windows 下的 DLL 依赖（如
numpy依赖的 OpenBLAS）、C 扩展模块（如lxml）可能引发静默失败，此时需配合depends.exe或ldd（WSL）检查二进制依赖
真正麻烦的不是缺哪个模块，而是某些模块（如 PyQt5 的平台插件、matplotlib 的后端）缺的是资源文件而非纯 Python 模块——这时候光加 --hidden-import 没用，得用 --add-data 手动搬运。
