Table of Contents:

安装

pip install pyinstaller
# 安装成功:
pyinstaller -version

使用

pyinstaller -F helloworld.py

相关参数:
* -F 表示打包成单独的 .exe 文件,这时生成的 .exe 文件会比较大,而且运行速度回较慢。仅仅一个 helloworld 程序,生成的文件就 5MB 大。
* -i 还可以指定可执行文件的图标;
* -w 表示去掉控制台窗口,这在 GUI 界面时非常有用。不过如果是命令行程序的话那就把这个选项删除吧!

PyInstaller 会对脚本进行解析,并做出如下动作:
1、在脚本目录生成 helloworld.spec 文件; 
2、创建一个 build 目录; 
3、写入一些日志文件和中间流程文件到 build 目录; 
4、创建 dist 目录; 
5、生成可执行文件到 dist 目录;

注意事项
1. 直接运行最终的 .exe 程序,可能会出现一闪而过的情况,这种情况下要么是程序运行结束(比如直接打印的 helloWorld),要么程序出现错误退出了。这种情况下,建议在命令行 cmd 下运行 .exe 文件,这时就会有文本输出到窗口;
2. 写代码的时候应当有个良好的习惯,用什么函数导什么函数,不要上来 import 整个库,最后你会发现你一个 100KB 的代码打包出来有 500MB;
3. 当你的代码需要调用一些图片和资源文件的,这是不会自动导入的,需要你自己手动复制进去才行。不然 exe 文件运行时命令窗口会报错找不到这个文件。

在包中导入其他资源:

假设程序中需要引入一个 test.txt 文件,首先我们运行:

pyi-makespec -F helloworld.py

此时会生成一个 .spec 文件,这个文件会告诉 pyinstaller 如何处理你的脚本,pyinstaller 创建一个 exe 的文件就是依靠它里面的内容进行执行的。

正常情况下你不需要去修改这个 spec 文件,除非你需要打包一个 dll 或者 so 文件或者其他数据文件。
那么我们就需要修改这个 spec 文件:

a = Analysis(['helloworld.py'],
             pathex=['/home/test'],
             binaries=[],
             datas=[], ### <------- 改修改为:


a = Analysis(['helloworld.py'],
             pathex=['/home/test'],
             binaries=[],
             datas=[('test.txt','.')], ## <---- 修改此处添加外部文件

然后在生成 exe 文件:

pyinstaller helloworld.spec

然后生成的文件就可以正常引入外部文件了。

兼容问题

在win11上用python311用pyinstaller打包成单独的exe,在win7上运行报如下的错误:

问题一:Error loading Python DLL
首先是出现以下这个问题,Error loading Python DLL xxx python311.dll,LoadLibrary: PyInstaller: FormatMessageW failed.

出错原因
发现是因为 Python 3.9 不再支持 win7 了,需要把 Python 版本降到 Python3.8 及以下。

解决方案
1. 用anaconda重新建立虚拟环境,这次注意设置下python的版本

conda create -n xxx python=3.8
  1. 安装下你需要的依赖库,比如:
 pip install -r requirements.txt

其他问题

在打了一个从视频流中进行物体识别的包,因为依赖的库有opencv、pytorch等,而他们有依赖很多其他的库,导致打完的包体有三百多M,在运行的时候前边有一段时间没有反应。后来发现是在运行打包的程序时,python的打包程序会先把python程序依赖的解释器、库、三方的python包解压到类似 C:\Users\sunxv\AppData\Local\Temp\_MEI676042 这样的目录。所以会导致程序有一段解压的时间消耗。

linux下使用

pyinstaller -D -F -n main -c "main.py"

pyinstaller -D -F -c "gen_proto_data_from_file.py"
pyinstaller -F  "gen_proto_data_from_file.py"

参考链接