Table of Contents:

 简介

Python 程序都是脚本的方式,一般是在解析器里运行,如果要发布出去,需要提前安装解析器才可以运行,为了在 Windows 里方便发布,并且打包所需要库文件,这样发布给用户使用就会更方便。
PyInstaller 是一个十分有用的第三方库,可以用来打包 python 应用程序,打包完的程序就可以在没有安装 Python 解释器的机器上一键运行了。

 安装

pip install pyinstaller
# 或者
python -m 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

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

 参考链接

Python程序打包成exe可执行文件