python之pyinstaller库将python脚本编译成可执行程序（windows系统）

前言

Python是一个脚本语言，被解释器解释执行。它的发布方式：

• .py文件：对于开源项目或者源码没那么重要的，直接提供源码，需要使用者自行安装Python并且安装依赖的各种库。（Python官方的各种安装包就是这样做的）

• .pyc文件：有些公司或个人因为机密或者各种原因，不愿意源码被运行者看到，可以使用pyc文件发布，pyc文件是Python解释器可以识别的二进制码，故发布后也是跨平台的，需要使用者安装相应版本的Python和依赖库。

• 可执行文件：对于非码农用户或者一些小白用户，你让他装个Python同时还要折腾一堆依赖库，那简直是个灾难。对于此类用户，最简单的方式就是提供一个可执行文件，只需要把用法告诉Ta即可。比较麻烦的是需要针对不同平台需要打包不同的可执行文件（Windows,Linux,Mac,...）。

安装PyInstaller

对于那些网络比较稳定，能够流畅使用pip源地址的用户，直接下面的命令就可以搞定：

pip install pyinstaller

通常我们会下载源码包，然后进入包目录，执行下面的命令（需要安装setuptools）：

python setup.py install

安装完后，检查安装成功与否：

pyinstaller --version

安装成功后，就可以使用下面的命令了：

• pyinstaller : 打包可执行文件的主要命令，详细用法下面会介绍。
• pyi-archive_viewer : 查看可执行包里面的文件列表。
• pyi-bindepend : 查看可执行文件依赖的动态库（.so或.dll文件）
• pyi-... : 等等。

Pyinstaller的使用

需要明确的几点：

① Pyinstaller是命令行工具，不需要进入python内部去输入执行代码

② Pyinstaller可以使程序脱离解析器运行，还能防止源代码泄漏（打包的时候已经把解析器给封装进去了）

③ Pyinstaller打包简单、粗暴、无脑

pyinstaller的语法：

pyinstaller [options] script [script ...] | specfile

最简单的用法，在和myscript.py同目录下执行命令：

pyinstaller mycript.py

然后会看到新增加了两个目录build和dist，dist下面的文件就是可以发布的可执行文件，对于上面的命令你会发现dist目录下面有一堆文件，各种都动态库文件和myscrip可执行文件。有时这样感觉比较麻烦，需要打包dist下面的所有东西才能发布，万一丢掉一个动态库就无法运行了，好在pyInstaller支持单文件模式，只需要执行：

pyinstaller -F mycript.py

你会发现dist下面只有一个可执行文件，这个单文件就可以发布了，可以运行在你正在使用的操作系统类似的系统的下面。

pyinstaller的各主要参数说明

• -F 表示生成单个可执行文件；
• -D –onedir 创建一个目录，包含exe文件，但会依赖很多文件（默认选项）。
• -w 表示去掉控制台窗口，这在GUI界面时非常有用。不过如果是命令行程序的话那就把这个选项删除吧！；
• -c –console, –nowindowed 使用控制台，无界面(默认)；
• -p 表示你自己自定义需要加载的类路径，一般情况下用不到；
• -i 表示可执行文件的图标。

.spec文件

在执行pyInstaller命令的时候，会在和脚本相同目录下，生成一个.spec文件，该文件会告诉pyinstaller如何处理你的所有脚本，同时包含了命令选项。一般我们不用去理会这个文件，若需要打包数据文件，或者给打包的二进制增加一些Python的运行时选项时...一些高级打包选项时，需要手动编辑.spec文件。可以使用：

pyi-makespec options script [script ...]

创建一个.spec文件，对于手动编辑的.spec文件，我们可以使用下面任意一条命令：

pyinstaller specfile
pyi-build specfile

常用指令

 注意:指定路径生成可执行文件的命令参数distpath前面是 两个 -

pyInstaller的原理简介

PyInstaller其实就是把python解析器和你自己的脚本打包成一个可执行的文件，和编译成真正的机器码完全是两回事，所以千万不要指望成打包成一个可执行文件会提高运行效率，相反可能会降低运行效率；好处就是在运行者的机器上不用安装python和你的脚本依赖的库。在Linux操作系统下，它主要用的binutil工具包里面的ldd和objdump命令。

PyInstaller输入你指定的的脚本，首先分析脚本所依赖的其他脚本，然后去查找，复制，把所有相关的脚本收集起来，包括Python解析器，然后把这些文件放在一个目录下，或者打包进一个可执行文件里面。

可以直接发布输出的整个文件夹里面的文件，或者生成的可执行文件。你只需要告诉用户，你的应用App是自我包含的，不需要安装其他包，或某个版本的Python，就可以直接运行了。

需要注意的是，PyInstaller打包的执行文件，只能在和打包机器系统同样的环境下。也就是说，不具备可移植性，若需要在不同系统上运行，就必须针对该平台进行打包。

实例

1、直接生成可执行文件

进入桌面，打开命令行，指引文件路径

pyinstaller -F 游戏.py

命令行的输入及输出结果如下：

 生成的桌面文件有：（共四个文件，其中可执行文件就是在dist（distribute发布的缩写）文件夹下面）

 进入dist文件夹后，双击这个可执行文件，程序就会自动运行

2、修改图标

操作如下：（还是以桌面游戏.py为例，注意尽量使用英文命名，不然会修改不了图标），这里首先介绍一下查找ico文件的网站，ico图标下载

注意：图标和py文件放置在一起，尽量都使用 英文 进行文件命名，代码如下

pyinstaller -i youxi.ico -F youxi.py

输出的结果为：

dist文件夹下的可执行程序如下（图标修改完成）

3、修改名称

还是同一个文件，在修改图标的同时修改文件名称，输入指令如下：

pyinstaller -i youxi.ico -F youxi.py -n demo

输出的结果为：

修改路径

还是相同的文件，在修改图标的同时修改文件名称再修改输出的文件路径，输入指令如下:

pyinstaller -i youxi.ico -F youxi.py  -n name --distpath C:\Users\86177\Desktop

输出的结果为：（输出的没有dist文件夹了，直接生成可执行.exe文件在桌面）