PyInstaller是python脚本打包成可执行程序的最有效的方法,支持python2.7~3.7。支持Windows、GNU/Linux、Mac OS X、FreeBSD、Solaris and AIX等 平台 ,总的来说如果你想打包你的python脚本,它是最优的选择。

安装 PyInstaller( 国内安装如果下载慢推荐采用清华源 ):


pip install PyInstaller

下面我们对其参数简单介绍下:

1)通用参数:

参数名 描述 说明
-h 显示帮助
-v 显示版本号
–distpath 生成文件放在哪里 默认:当前目录的dist文件夹内
–workpath 生成过程中的中间文件放在哪里 默认:当前目录的build文件夹内
-y 如果dist文件夹内已经存在生成文件,则不询问用户,直接覆盖 默认:询问是否覆盖
–upx-dir UPX_DIR 指定upx工具的目录 默认:execution path
-a 不包含unicode支持 默认:尽可能支持unicode
–clean 在本次编译开始时,清空上一次编译生成的各种文件 默认:不清除
–log-level LEVEL 控制编译时pyi打印的信息 一共有5个等级,由低到高分别为TRACE DEBUG INFO(默认) WARN ERROR CRITICAL。也就是默认清空下,不打印TRACE和DEBUG信息

2)其他参数

参数名 描述 说明
-D 生成one-folder的程序(默认) 生成结果是一个目录,各种第三方依赖、资源和exe同时存储在该目录
-F 生成one-file的程序 生成结果是一个exe文件,所有的第三方依赖、资源和代码均被打包进该exe内
–specpath 指定.spec文件的存储路径 默认:当前目录
-n 生成的.exe文件和.spec的文件名 默认:用户脚本的名称,即main.py和main.spec
-d执行生成的main.exe时,会输出pyi的一些log,有助于查错默认:不输出pyi的log
-s优化符号表不建议在windows上使用
–noupx强制不使用upx推荐使用
–runtime-tmpdir指定运行时的临时目录默认:使用系统临时目录
–add-data 打包额外资源 用法:pyinstaller main.py –add-data=src;dest。windows以;分割,linux以:分割
–add-binary 打包额外的代码 用法:同–add-data。与–add-data不同的是,用binary添加的文件,pyi会分析它引用的文件并把它们一同添加进来
-p 指定额外的import路径,类似于使用PYTHONPATH 参见PYTHONPATH
–hidden-import 打包额外py库 pyi在分析过程中,有些import没有正确分析出来,运行时会报import error,这时可以使用该参数
–additional-hooks-dir 指定用户的hook目录 hook用法参见其他,系统hook在PyInstaller\hooks目录下
–runtime-hook 指定用户runtime-hook 如果设置了此参数,则runtime-hook会在运行main.py之前被运行
–exclude-module 需要排除的module pyi会分析出很多相互关联的库,但是某些库对用户来说是没用的,可以用这个参数排除这些库,有助于减少生成文件的大小
–key pyi会存储字节码,指定加密字节码的key 16位的字符串

打包python程序:


# 在Terminal下输入如下命令就可以制作出exe,生成的文件默认放在同目录dist下
pyinstaller -F -w *.py

总体来说操作很便捷,当然有时候我们也想将打包好的程序拆成python脚本,这个可以查看之前的我的一篇博文:Pyinstaller解包&反编译pyc文件教你如何解包。

参考资料:

1.http://www.pyinstaller.org/documentation.html

2.https://pyinstaller.readthedocs.io/en/stable/installation.html#installing-in-windows