PyInstaller打包后报ModuleNotFoundError的根本原因是其静态分析无法捕获动态导入（如importlib.import_module）和隐式依赖。解决方法包括：加--debug查看缺失模块；用--collect-all强制包含整包；在.spec的hiddenimports中手动添加完整模块路径；配合datas/binaries处理数据文件和C扩展；统一通过.spec的datas字段而非--add-data跨平台管理资源路径。
PyInstaller打包后报ModuleNotFoundError怎么办
PyInstaller不是全自动的模块探测器，它靠静态分析入口脚本的import语句找依赖，但很多动态导入（如importlib.import_module、__import__、字符串拼接导入）或隐式依赖（如插件目录、配置驱动的模块加载）根本不会被扫描到——这就是ModuleNotFoundError最常出现的根本原因。
- 先确认缺失模块是否真的没被打包：运行打包后的程序时加
--debug参数，观察启动日志中importing和missing相关行 - 用
pyinstaller --collect-all <module_name></module_name>强制包含整个包（适用于像sklearn、matplotlib这类有数据文件或子模块动态加载的库） - 如果模块是通过字符串名导入（比如
plugin_name = "myplugin"; importlib.import_module(plugin_name)），必须在.spec文件里手动加到hiddenimports列表中
如何正确配置.spec文件添加隐藏依赖
直接改.spec比反复加命令行参数更可控，尤其当项目有多个动态导入点时。生成.spec后（pyinstaller main.py会自动生成），编辑它，在a = Analysis(...)这一段里补全hiddenimports。
-
hiddenimports是字符串列表，每个元素是模块的**完整路径名**（如"pkg.submodule"，不是"submodule.py"） - 不要写相对路径或
.py后缀；如果模块在本地./plugins/下，需确保该目录已作为包（含__init__.py），再写"plugins.myplugin" - 若模块依赖C扩展或数据文件（如
nltk的语料、pydantic的编译模块），仅加hiddenimports不够，得配合datas或binaries字段
a = Analysis(
['main.py'],
pathex=['.'],
binaries=[],
datas=[('plugins/', 'plugins/')], # 把plugins目录整体复制进dist
hiddenimports=['plugins.auth', 'utils.config_loader'],
...
)
--add-data和datas字段怎么填才不报错
Windows/macOS/Linux路径分隔符不同，--add-data命令行参数在跨平台打包时极易出错——错误表现为资源找不到、路径变成os.path.join(sys._MEIPASS, 'xxx')后拼接失败，甚至启动就崩溃。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 命令行用
--add-data "src;dest"（Windows）或--add-data "src:dest"（Linux/macOS），但统一推荐走.spec里的datas字段，格式固定为[('源路径', '目标路径')]元组列表 - 源路径是**相对于
.spec所在目录**的相对路径，目标路径是打包后程序运行时sys._MEIPASS下的相对路径（即最终在dist/app/里看到的结构） - 读取资源时必须用
os.path.join(sys._MEIPASS, '目标路径')，不能硬编码"./data/config.json"——因为PyInstaller运行时工作目录不一定是dist/app
调试时如何快速定位哪个模块没打进去
别靠猜。最有效的方式是让打包后的程序启动时打印所有已加载模块路径，再对比缺失模块是否在其中。
立即学习“Python免费学习笔记（深入）”；
- 在主脚本开头插入：
import sys<br>print("sys.path:", sys.path)<br>print("frozen?", getattr(sys, 'frozen', False)) - 运行打包版程序，看输出的
sys.path里有没有temp_MEIxxxxxx这类临时路径（说明已进入frozen模式），再检查该路径下是否存在对应模块目录 - 用
7z或unzip直接解压dist/app/app.exe（Windows）或dist/app/app（macOS/Linux），搜索缺失模块名，确认物理上是否存在
动态导入逻辑越复杂，hiddenimports越容易漏；而资源路径写死、没走sys._MEIPASS，是比模块缺失更隐蔽的运行时错误来源。
