PyInstaller使用教程

 

简介

PyInstaller是一个第三方库，它可以在Windows、Linux、 Mac OS X 等操做系统下将 Python 源文件打包， 经过对源文件打包， Python 程序能够在没有安装 Python 的环境中运行，也能够做为一个 独立文件方便传递和管理。

PyInstaller支持Python 2.7和Python 3.3+。能够在Windows、Mac OS X和Linux上使用，可是并非跨平台的，而是说你要是但愿打包成.exe文件，须要在Windows系统上运行PyInstaller进行打包工做；打包成mac app，须要在Mac OS上使用。

 

安装与更新

安装：pip/pip3 install pyinstaller

更新:pip/pip3 install --upgrade pyinstalle

注意：

1.PyInstaller 库会自动将 PyInstaller 命令安装到 Python 解释器 目录中，与 pip 或 pip3 命令路径相同，所以能够直接使用。 

2.Windows上运行PyInstaller还须要PyWin32或者pypiwin32，其中pypiwin32在你安装PyInstaller的时候会自动安装。

 

 

PyInstaller生成可执行程序

PyInstaller 工具的命令语法以下：

pyinstaller 选项 Python 源文件

无论这个 Python 应用是单文件的应用，仍是多文件的应用，只要在使用 pyinstaller 命令时编译做为程序入口的 Python 程序便可。

PyInstaller工具是跨平台的，它既能够在 Windows平台上使用，也能够在 Mac OS X 平台上运行。在不一样的平台上使用 PyInstaller 工具的方法是同样的，它们支持的选项也是同样的。

下面先建立一个 app 目录，在该目录下建立一个 app.py 文件，文件中包含以下代码：

from say_hello import *
def main(): print('程序开始执行') print(say_hello('孙悟空')) # 增长调用main()函数
if __name__ == '__main__': main()

接下来使用命令行工具进入到此 app 目录下，执行以下命令：

pyinstaller -F app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在此 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app.exe 文件，这就是使用 PyInstaller 工具生成的 EXE 程序。

在命令行窗口中进入 dist 目录下，在该目录执行 app.exe ，将会看到该程序生成以下输出结果：

程序开始执行 孙悟空，您好！

因为该程序没有图形用户界面，所以若是读者试图经过双击来运行该程序，则只能看到程序窗口一闪就消失了，这样将没法看到该程序的输出结果。

在上面命令中使用了-F 选项，该选项指定生成单独的 EXE 文件，所以，在 dist 目录下生成了一个单独的大约为 6MB 的 app.exe 文件（在 Mac OS X 平台上生成的文件就叫 app，没有后缀）；与 -F 选项对应的是 -D 选项（默认选项），该选项指定生成一个目录（包含多个文件）来做为程序。

下面先将 PyInstaller 工具在 app 目录下生成的 build、dist 目录删除，并将 app.spec 文件也删除，而后使用以下命令来生成 EXE 文件。

pyinstaller -D app.py

执行上面命令，将看到详细的生成过程。当生成完成后，将会在 app 目录下看到多了一个 dist 目录，并在该目录下看到有一个 app 子目录，在该子目录下包含了大量 .dll 文件和 .pyz 文件，它们都是 app.exe 程序的支撑文件。在命令行窗口中运行该 app.exe 程序，一样能够看到与前一个 app.exe 程序相同的输出结果。

PyInstaller 不只支持 -F、-D 选项，并且也支持如表 1 所示的经常使用选项。

表 1 PyInstaller 支持的经常使用选项

-h，--help	查看该模块的帮助信息
-F，-onefile	产生单个的可执行文件
-D，--onedir	产生一个目录（包含多个文件）做为可执行程序
-a，--ascii	不包含 Unicode 字符集支持
-d，--debug	产生 debug 版本的可执行文件
-w，--windowed，--noconsolc	指定程序运行时不显示命令行窗口（仅对 Windows 有效）
-c，--nowindowed，--console	指定使用命令行窗口运行程序（仅对 Windows 有效）
-o DIR，--out=DIR	指定 spec 文件的生成目录。若是没有指定，则默认使用当前目录来生成 spec 文件
-p DIR，--path=DIR	设置 Python 导入模块的路径（和设置 PYTHONPATH 环境变量的做用类似）。也可以使用路径分隔符（Windows 使用分号，Linux 使用冒号）来分隔多个路径
-n NAME，--name=NAME	指定项目（产生的 spec）名字。若是省略该选项，那么第一个脚本的主文件名将做为 spec 的名字

在表 1 中列出的只是 PyInstaller 模块所支持的经常使用选项，若是须要了解 PyInstaller 选项的详细信息，则可经过 pyinstaller -h 来查看。