PyInstaller打包自定义包报ModuleNotFoundError及exe运行咨询

报错原因 #

PyInstaller自动分析依赖时，没有将和入口文件app.py同级的自定义Interfaces包纳入打包范围。源码运行时Python会自动读取当前工作目录下的包，但打包后的独立运行环境没有默认包含这个目录的搜索路径，就会找不到模块。

修复方案 #

按优先级试以下操作：

• 给打包命令加--paths参数，把项目根目录加入PyInstaller的模块搜索路径，修改后的命令：

pyinstaller --onefile --icon=icon.ico --windowed --paths=. .\app.py

参数里的.代表当前执行命令的目录，也就是你存放app.py和Interfaces文件夹的项目根目录。

• 如果执行上面的命令后还是报同样的错，再加--hidden-import参数显式声明需要打包的自定义模块，把Interfaces下用到的模块都列进去：

pyinstaller --onefile --icon=icon.ico --windowed --paths=. --hidden-import=Interfaces --hidden-import=Interfaces.mainmenu --hidden-import=Interfaces.login .\app.py

后续Interfaces下新增的模块如果没被自动识别，按同样格式追加--hidden-import参数即可。

• 如果Interfaces目录下存了非Python文件（比如图片、ui文件、配置文件），还要额外加--add-data参数把这些资源打包进去，Windows系统下参数格式为--add-data="本地源路径;打包后内路径"，比如要打包Interfaces下的assets文件夹，就追加参数--add-data="Interfaces/assets;Interfaces/assets"。

只要打包流程正确，用--onefile生成的单文件exe可以直接发给其他同平台Windows电脑运行，不需要对方提前安装Python或者项目用到的第三方Python库，注意几个兼容要点：

• 架构匹配：64位系统下打包的exe只能在64位Windows上运行，32位系统打包的exe可以同时兼容32/64位系统，根据目标用户的系统选择打包环境即可。
• 系统版本匹配：高版本Windows打包的程序不能直接在过低版本的Windows上运行，比如Win11+Python3.10以上环境打包的程序，默认无法在Win7上运行，需要兼容老系统的话要在对应低版本系统环境下打包。
• 非Python依赖无法自动打包：如果你的代码调用了系统级的外部组件（比如VC++运行库、本地注册的COM组件、第三方独立exe工具），这些内容不在Python依赖范围内，需要对方电脑提前安装对应组件才能正常运行，纯Python实现的代码和依赖都不需要额外安装。

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