Python PyInstaller 安装和使用教程( 打包生成 exe )

From：http://c.biancheng.net/view/2690.html

Python zipapp打包教程：http://c.biancheng.net/view/2687.html

在创建了独立应用（自包含该应用的依赖包）之后，还可以使用 PyInstaller 将 Python 程序生成可直接运行的程序，这个程序就可以被分发到对应的 Windows 或 Mac OS X 平台上运行。

安装 PyInstalle

Python 默认并不包含 PyInstaller 模块，因此需要自行安装 PyInstaller 模块。

安装 PyInstaller 模块与安装其他 Python 模块一样，使用 pip 命令安装即可。在命令行输入如下命令：

pip install pyinstaller

强烈建议使用 pip 在线安装的方式来安装 PyInstaller 模块，不要使用离线包的方式来安装，因为 PyInstaller 模块还依赖其他模块，pip 在安装 PyInstaller 模块时会先安装它的依赖模块。

运行上面命令，应该看到如下输出结果：

Successfully installed pyinstaller-x.x.x

其中的 x.x.x 代表 PyInstaller 的版本。

在 PyInstaller 模块安装成功之后，在 Python 的安装目录下的 Scripts(D:\Python\Python36\Scripts) 目录下会增加一个 pyinstaller.exe 程序，接下来就可以使用该工具将 Python 程序生成 EXE 程序了。

PyInstaller 生成可执行程序

PyInstaller 工具的命令语法如下：pyinstaller 选项 Python 源文件
不管这个 Python 应用是单文件的应用，还是多文件的应用，只要在使用 pyinstaller 命令时编译作为程序入口的 Python 程序即可。
PyInstaller工具是跨平台的，它既可以在 Windows平台上使用，也可以在 Mac OS X 平台上运行。
在不同的平台上使用 PyInstaller 工具的方法是一样的，它们支持的选项也是一样的。

PyInstaller 支持的常用选项

表 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 来查看。

示例 1 ：创建一个命令行程序

创建一个 app 目录，
在该目录下创建一个 test_2.py 文件，文件中包含如下代码：

def say_word(word: str = None):print(word)passif __name__ == '__main__':say_word('this is test_2 model')

在该目录下创建一个 test_1.py 文件，文件中包含如下代码：

from test_2 import say_wordif __name__ == '__main__':word = 'hello world'say_word(word)

接下来使用命令行工具进入到此 app 目录下，执行如下命令：pyinstaller -F test_1.py

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

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

由于该程序没有图形用户界面，因此如果读者试图通过双击来运行该程序，则只能看到程序窗口一闪就消失了，这样将无法看到该程序的输出结果。

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

下面先将 PyInstaller 工具在 app 目录下生成的 build、dist 目录删除，并将 test_1.spec 文件也删除，

然后使用如下命令来生成 EXE 文件：pyinstaller -D test_1.py

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

示例 2 ：创建一个 GUI 程序（使用 PyQT5）

示例代码（ test_gui.py ）：

import sys
# from PyQt5 import QtCore
from PyQt5.QtWidgets import (QApplication, QMainWindow, QDesktopWidget, QHBoxLayout, QVBoxLayout,QPushButton, QListView, QLabel, QLineEdit, QWidget
)
from PyQt5.QtCore import Qtclass TBGUISpider(QMainWindow):def __init__(self):super(TBGUISpider, self).__init__()# self.setWindowFlags(QtCore.Qt.WindowMinimizeButtonHint)self.resize(1200, 800)# self.setFixedSize(self.width(), self.height())self._center_display()self._ini_ui()self.show()def _center_display(self):"""控制窗口显示在屏幕中心的方法:return:"""# 获得窗口qr = self.frameGeometry()# 获得屏幕中心点cp = QDesktopWidget().availableGeometry().center()# 显示到屏幕中心qr.moveCenter(cp)self.move(qr.topLeft())def _ini_ui(self):###########################################main_widget = QWidget()self.setCentralWidget(main_widget)h_box_1 = QHBoxLayout()# h_box_1.addStretch(2)btn_login = QPushButton('登录淘宝', self)btn_login.resize(80, 50)# btn_login.move(10, 10)btn_start = QPushButton('开始采集', self)btn_start.setEnabled(False)btn_start.resize(80, 50)# btn_start.move(100, 10)btn_terminate = QPushButton('结束采集', self)btn_terminate.setEnabled(False)btn_terminate.resize(80, 50)# btn_terminate.move(200, 10)h_box_1.addWidget(btn_login, 0, Qt.AlignLeft | Qt.AlignTop)h_box_1.addWidget(btn_start, 0, Qt.AlignLeft | Qt.AlignTop)h_box_1.addWidget(btn_terminate, 0, Qt.AlignLeft | Qt.AlignTop)###########################################h_box_2 = QHBoxLayout()list_view = QListView(self)list_view.resize(1200, 500)h_box_2.addWidget(list_view)###########################################h_box_3 = QHBoxLayout()# lable_search_key = QLabel('关键字', self)# line_edit_key = QLineEdit()###########################################v_box = QVBoxLayout()# v_box.addStretch(1)v_box.addLayout(h_box_1)v_box.addLayout(h_box_2)v_box.addLayout(h_box_3)v_box.setStretchFactor(h_box_1, 1)v_box.setStretchFactor(h_box_2, 8)v_box.setStretchFactor(h_box_3, 1)self.centralWidget().setLayout(v_box)passif __name__ == '__main__':app = QApplication(sys.argv)form = TBGUISpider()form.show()app.exec_()

直接运行 python 程序结果：