PyInstaller 打包py程序的问题总结

概述

最近用PyInstaller实现了将py程序打包为exe可执行文件,这里总结一下打包过程中遇到的问题和解决方法。网上有关PyInstaller安装和使用的教程很多,这里不再赘述。

问题与解决方法

一、找不到文件

FileNotFoundError: [Errno 2] No such file or directory: 'file_path'

以上报错,表示某个文件没有找到,通过报错信息提示的file_path找到缺少的文件,将其拷贝到file_path对应的目录即可。
注:一般情况下,缺少的文件都会在py环境安装路径对应的Lib\site-packages中找到,这里推荐使用Everything来快速找到文件。

二、找不到模块

ImportError: No module named 'module_name'

解决方法如下:

  1. 升级PyInstaller版本
    一般情况下,PyInstaller会帮我们将程序所引用的所有模块自动打包到exe可执行文件所在的目录,如果打包后报错提示找不到模块,可以尝试升级PyInstaller版本。

  2. 手动引入模块
    使用--hidden-import命令添加模块,即pyinstaller your_script_path --hidden-import module_name

  3. 直接拷贝模块
    如果以上的方法都无法解决文件,可以参考问题一的解决方法,用Everything找到缺少的模块,直接拷贝到exe可执行文件所在的目录。需要注意的是,缺少的模块可能是文件夹也可能是单一文件。例如textwrap3.py、xarray等等

补充

上文中,我们提到使用--hidden-import来手动引入模块,但是当需要手动引入的模块很多时,会在PyInstaller命令后面跟上非常多的--hidden-import xxx。很容易遗漏或者写错。
我们可以先不添加引入模块,直接执行打包

pyinstaller your_script_path

在程序目录下会生成一个与程序同名的.spec文件,我们修改.spec文件中hiddenimports的内容,添加需要手动引入的模块,如下:

# ...
a = Analysis(['your_script_path'],
             pathex=[''],
             binaries=[],
             datas=[],
             hiddenimports=['module_name1','module_name2','module_name3', ...],
             hookspath=[],
             hooksconfig={},
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
# ...

最后执行.spec文件

pyinstaller your_script_path.spec

这样可以清楚的看到手动引入的模块,不用每次添加大量的--hidden-import。当然,重新打包程序则会覆盖.spec文件,记得保留和替换。

©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容