python 打包生成exe可执行文件

Myth丶恋晨 2023-01-11 08:56 218阅读 0赞

公众号后台回复**“图书“**，了解更多号主新书内容

作者：朱小五

来源：凹凸数据

## 标准打包 ##

目前比较常见的打包exe方法都是通过`Pyinstaller`来实现的，本文也将使用这种常规方法。如果对这块已经很熟悉的小伙伴，可以直接下滑到本文下半部分。

### 为什么要打包？ ###

众所周知，Python脚本不能在没有安装Python的机器上运行。

那我们如果写了一个数据分析/自动化办公的小脚本，想分享给同事小姐姐使用，可她电脑又没有装Python。

这个时候如果将脚本打包成exe文件，微信发送给她，即使她的电脑上没有安装Python解释器，这个exe程序也能在上面运行。岂不美哉？

![format_png][]

（当然，想通过帮安装Python跟小姐姐建立感情的话，就当我没说）

### 安装Pyinstaller ###

首先我们要先安装Pyinstaller，直接在cmd使用pip命令

pip install pyinstaller

如果网速太慢可以切换国内源来加速，本文其他部分直接使用国内源，不再重复注释。

![format_png 1][]

1.  `pip install -i https://pypi.douban.com/simple/ pyinstaller #豆瓣源`
2.  `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller #清华源`

### Pyinstaller打包步骤 ###

这里我们拿之前《[Python自动化办公 | 同事要我帮忙补写178份Word日报！][Python_ _ _178_Word]》这篇的python代码，作为案例来演示。将其中脚本`py_word.py`，待处理的表格文件`workbook.xlsx`，以及准备好的软件图标图片`chengzi.ico`放在了我电脑的`F:\py_word`目录下（如果大家感兴趣的话，可以在文末下载获取）

![format_png 2][]

1、cmd切换到我们刚刚放文件的目录

![format_png 3][]

2、执行命令Pyinstaller -F -w -i chengzi.ico py\_word.py，执行过程特别漫长，就没有录制动图。

执行完毕会发现当前目录多了几个文件夹，打开其中名为dist的文件夹。

![format_png 4][]

已经生成了一个名为`py_word`的exe应用程序，并且图标也是我们设置的橙子图案，看来已经成功一半了。

要不运行一下，试试能否正常生成word日报？

![format_png 5][] 打包exe后执行

成功运行，可惜就是文件有点大（339M）

![format_png 6][]

### Pyinstaller参数详解 ###

说回刚刚执行的命令

Pyinstaller -F -w -i chengzi.ico py_word.py

给大家解释一下其中Pyinstaller的参数，其中`-F`参数代表制作独立的可执行程序。

`-w`是指程序启动的时候不会打开命令行。如果不加-w的参数，就会有黑洞洞的控制台窗口出来。比如在刚才的脚本里我加一行`print('Hello World!')`，那么就不要放-w参数了，不然运行会报错，毕竟`Hello World!`需要在命令行里打印出来。此外，`-w`参数在GUI界面时非常有用。

最后的`-i chengzi.ico`就是指设置自己的图标图案，因为默认打包图片是下图这样的。这个参数也可以写成`--icon=chengzi.ico`

![format_png 7][]

最后稍微总结一下：

1.  `Pyinstaller -F py_word.py 打包exe`
2.   
3.  `Pyinstaller -F -w py_word.py 不带控制台的打包`
4.   
5.  `Pyinstaller -F -w -i chengzi.ico py_word.py 打包指定exe图标打包`

以上三个是比较常用的参数，其他参数详见下表

![format_png 8][]

Pyinstaller参数大全

### ico图片生成 ###

自己做的软件都喜欢放上自己的图标，不过哪来那么多ico图片呢？

一个是可以找专门的ico图片网站，不过都很小众，图片库也很小。

另一个是可以自己生成，这里就给大家分享一个网站，可以把其他格式图片转成ico格式：https://app.xunjiepdf.com/img2icon/

![format_png 9][] ico图片格式转换

## 压缩打包 ##

好了，小伙伴们

来到了最激动人心的时刻，刚刚生成的exe实在太大了，300多M的软件程序想用微信传一下都费劲。

我也试过很多方法，比如：修改spec文件自定义打包、pipenv 虚拟环境、使用开源的upx压缩等等，但是往往要么过程比较麻烦，要么成功率不高（压缩成不成功全看脸）。

而我要分享的，是自己一直在用的，最简单且成功率极高的方法——conda创建虚拟环境。

![format_png 10][]

### Python打包为什么大？ ###

在压缩打包之前，先简单说一下为什么Python打包过大？

Python打包exe，不但体积大而且运行奇慢。解释型语言大都是这个样子，只不过Python尤其突出。要解决大而慢，只能用编译型语言，如C，C++，甚至VB都好很多，体积最小的是汇编。\[1\]

此外，还有知乎大佬说是因为“Anaconda里内置了很多库，打包的时候打包了很多不必要的模块进去，要用纯净的Python来打包。”

所以我们可以模拟一个新环境，其中只安装我们本次打包所必要的工具包即可。

那最适合的就是——虚拟环境了！

### 虚拟环境 ###

Python创建虚拟环境的方法有很多，而我是个Anaconda忠实用户，如果你跟我一样，那就简单了。（大家也可以使用Virtualenv、Pipenv来设置虚拟环境，善用搜索，方法大同小异）

先记几个命令，很简单

1.  `conda create -n 虚拟环境名字 python==3.6  #创建虚拟环境`
2.   
3.  `conda activate 虚拟环境名字  #激活虚拟环境`
4.   
5.  `conda deactivate  #退出虚拟环境`

从开始菜单运行“Anaconda Prompt”，出现的界面输入创建虚拟环境的指令。成功创建了一个名字为`aotu`，且基于python版本3.6的虚拟环境。

![format_png 11][]

在创建过程中需要回复（y/n），Yes，再激活虚拟环境

![format_png 12][]

conda安装的虚拟环境，会把虚拟环境的目录生成在anaconda安装目录下的env目录下。

![format_png 13][]

当然我们也可以在刚刚的窗口，使用命令`conda info --envs`，来查看conda环境下所有的虚拟环境

![format_png 14][]

### 安装所需的库 ###

上面我们已经创建并激活了名为`aotu`虚拟环境，输入`conda list`可以查看当前虚拟环境里已经安装的库。

![format_png 15][]

我们打开所要打包的Python脚本，对比上图，发现`pandas`，`docx`这两个库还需要额外安装。当然，也不能缺了打包必不可少的`pyinstaller`库。

![format_png 16][] 待打包脚本

安装库的过程不再赘述

1.  `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pandas`
2.   
3.  `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple python-docx`
4.   
5.  `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pyinstaller`

安装后再看

![format_png 17][]

已成功安装，还有一些因为这几个库所附带安装的，就不管他们了。

### Pyinstaller打包步骤 ###

这里就不再重复了，只换个苹果图标试试

Pyinstaller -F -w -i apple.ico py_word.py

![format_png 18][]

生成

![format_png 19][]

成功压缩到29.8M，如果不导入pandas这位大神，应该就可以10多M了

运行一下，毫无问题

![format_png 20][]

最后再简单总结一下**虚拟环境+打包的全过程**（只三步）：

1.  `#创建虚拟环境`
2.  `conda create -n aotu python=3.6`
3.   
4.  `#激活虚拟环境`
5.  `conda activate aotu`
6.   
7.  `#Pyinstaller打包`
8.  `Pyinstaller -F -w -i apple.ico py_word.py`

### 总结一些小坑 ###

1、说起来还是有点玄学，上文中一模一样的过程我在两个电脑都执行过一遍。在其中一个上显示缺少`xlrd`这个库，安装后成功打包，也是一样的大小。小伙伴们可以在文末获取文件，也试试。

2、在安装库是要注意一些库名，比如docx这个库不要`pip install docx`，而是需要

pip install python-docx

还有一些库可能因为版本不同导致不能使用，多碰碰壁就好了。

3、为了防止打包时候有些库没安装好，可以先在虚拟环境中执行一下Python脚本。运行无误的话再打包，比较保险。

![format_png 21][]

4、最后，如果想要删除虚拟环境的话，可执行下方命令

conda remove -n aotu--all

5、打包为exe的话，版本尽量选择python3.6+32位版本，因为win64位系统向下兼容32位程序，但是如果不考虑32位系统的话无所谓，直接python64位版本直接打包就可以，只是只能在win64位系统上跑。\[2\]

### 下载链接 ###

如果大家想测试Python打包，手头又没有合适的文件，可以在公众号后台回复“**打包**”即可获得以下文件：

![format_png 22][]

### ps: ###

windows环境下可能存在以下的问题，就是在运行打包命令的时候会报错，RecursionError: maximum recursion depth exceeded，具体如下图：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hpcWk0MTQ1_size_16_color_FFFFFF_t_70][]

解决方法如下l：

**pyinstaller 之后会生成一个和xxx.py文件对一个的  xxx.spec 文件****，如下图**

![20200107154911889.png][]

**打开xxx.spec文件，在行首导入sys包，然后设置一下递归调用的限制次数，可以尽量大一点，我这里设置100万次后就没有报错了，具体如下图所示**

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hpcWk0MTQ1_size_16_color_FFFFFF_t_70 1][]

修改之后，然后  **pyinstall   -F  xxx.spec **（你刚才修改过的文件）就行了,  --add-data 参数就不需要了，spec文件里面已经有了。

然后就解决了

[format_png]: /images/20221119/79fee32de5dd41009f839883d07cdad7.png
[format_png 1]: /images/20221119/29c0098e0f82439197d8e605475f1131.png
[Python_ _ _178_Word]: http://mp.weixin.qq.com/s?__biz=MzU5Nzg5ODQ3NQ%3D%3D&chksm=fe4ed6ddc9395fcb4cd4c9a946c7eaa8f1d281dfcba82655b6de4e9bc0ff359cb2f3d7da4623&idx=1&mid=2247496537&scene=21&sn=f185dd09ca14d99a7a803954aa6157ff#wechat_redirect
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy90WFlpY3Q0MHhmTGpKNW04UzE0OWlhSlpCSlhwRzdjUXBXaE5OTmtrR0RpYUpjOWQ5eU85VmxVWFEyYnU0bnRwTUhNYWdQVzl6UDZSTXhSTlJmQmljaHhSQUEvNjQw?x-oss-process=image/format,png
[format_png 3]: /images/20221119/4419c205fcb64175bbe9521a46fcc6e5.png
[format_png 4]: /images/20221119/9f231d1cf2a84b3b908821d7ee5a216b.png
[format_png 5]: /images/20221119/18c6b624c6ee449ebe88de27d0ee9985.png
[format_png 6]: /images/20221119/04141a6200da49d396eec3a812c0ed0f.png
[format_png 7]: /images/20221119/3ccf2f9079d243d8acd08de17208277a.png
[format_png 8]: /images/20221119/9634ac947a174ee4bf0c8c9f02078729.png
[format_png 9]: /images/20221119/58bf5f2d46104f63943f07c653c39c1f.png
[format_png 10]: /images/20221119/56d35b54112041b39e833a660f0f3d98.png
[format_png 11]: /images/20221119/f10fb42d4e694aa98b7aad1bc7eb1009.png
[format_png 12]: /images/20221119/65ad3784dd8a4a4ba1ddd4880436921c.png
[format_png 13]: /images/20221119/44933418ac0843839f128d112d31ce77.png
[format_png 14]: /images/20221119/9a9d24f06f804089b2aa19762ac2ce41.png
[format_png 15]: /images/20221119/5ec4b116ad4f442f81cca44332af571f.png
[format_png 16]: /images/20221119/715b3862f462423e8e4eceb6ab7b79da.png
[format_png 17]: /images/20221119/0f238e9bd16b43b395a62da25fc91f60.png
[format_png 18]: /images/20221119/478ab42cf5a64d238507469d95eed9b7.png
[format_png 19]: /images/20221119/eb9ccbf8745b495a938274fef320493c.png
[format_png 20]: /images/20221119/3b259d668315439faf06dd29a4d158cd.png
[format_png 21]: /images/20221119/20d31a67ed3c40f88082ed9f50598cb8.png
[format_png 22]: /images/20221119/1668544ebd394f63bf005d2bde5fc340.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hpcWk0MTQ1_size_16_color_FFFFFF_t_70]: /images/20221119/3f3056b9e92b494a8468787ab5712934.png
[20200107154911889.png]: /images/20221119/5b7d3ea4ec3f46f2804af1bb934066c0.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3hpcWk0MTQ1_size_16_color_FFFFFF_t_70 1]: /images/20221119/872161b2497a4036a9014f42e1e71b61.png