Python 打包 exe 程序避坑指南-技术圈

作者 | 杨炳
来源 | Python中文社区

写完一个python程序之后，如何才能快速地将代码分享给别人，尤其对于初学者来说，能把自己的代码包装成一个exe程序并传递到别人电脑上运行，那是一件非常有成就感的事。好在python自带简易打包程序，让很多人能过一把当程序员的瘾。目前流行的打包库就有py2exe、pyinstaller和cx_Freeze。

但python的运行环境复杂，编写的程序往往是借助了很多附加的功能库来实现，对简单的打包会造成一定困难。本人也是在经历了多次的打包失败和成功的经历之后，觉得pyinstaller的成功率最高，所以有必要针对pyinstaller写一篇避坑指南。

一、安装

使用python的pip安装，在cmd窗口，使用pip install pyinstaller，即安装完成。然后配置好环境变量。

二、使用

例如在程序6.py所在文件夹打开cmd窗口。一般输入pyintaller -F **.py（命令符的具体含义在下文中解释），回车即开始打包。顺利的话，会出现打包成功的反馈，如下图，这时，就说明文件已经打包完成了。dist文件夹里面就放着打包完的exe程序，使用时剪切出来就行了。如果运气好或者本身程序比较简单，那这个exe就能在任何电脑运行了。

但往往没这么容易，pyinstaller在使用中有很多坑，打包的开始，也是修补的开始。

三、遇坑填坑

1.文件路径中不能出现中文

否则会在打包过程中直接出现如下报错。这时只要把所在文件夹和程序名字改成英文或者数字重新打包即可。可以打包完再将exe的名字改回来。

2.缺少导入hook文件

有时即使打包成功了，在运行exe时候，还是会有报错并闪退。

如果报错为：FileNotFoundError: [Errno 2] No such file or directory:……

那是缺少hook文件，要在pyinstaller的安装路径里的hook增加一个自定义的hook。hook文件的命名规范为: hook-【库名】.py。例如以我在打包程序中用了结巴分词这个功能库为例，那我要建立一个hook-jieba.py，并写入：

from PyInstaller.utils.hooks import collect_data_files
datas = collect_data_files("jieba")

然后放到~\Lib\site-packages\PyInstaller\hooks中去，再次运行pyinstaller打包既可解决该问题。

3.缺少导入功能库模块

如果报错为 no moduler named “pandas._libs.skiplist”，那就要手动import库，解决方法打开生成的spec文件，找到 hiddenimports=[],加上要添加的库，将其改动如下，hiddenimports=["pandas._libs.skiplist"]，然后删除dist里面的exe文件，重新用spec文件打包，pyinstaller **.spec。即可解决该问题。

四、花式打包

涉及到打包的几个重要参数如下。

-F，将所有内容打包到一个exe中，方便发送，一般都使用这个参数。
-c，此为windows系统的默认选项，使用这个参数，运行时会有一个黑窗控制台。
-w，使用这个参数，运行时不会出现黑窗控制台。
-i 使用这个参数用于生成自定义图标的exe，在这后面要加上ico图片的地址。例如，pyinstaller -i D:\icons\demo.ico **.py

五、结语

将程序打包成exe发送出去或者供用户下载，是一个比较传统的传播方式，并且比较笨重，其实用简单的H5或者小程序就能实现一样的效果，对用户而言也更方便，也是朝着轻应用的方向发展。此外，对于专业用户还能通过github和api等方式传播。随着网络观念的深入人心和5G时代到来，相信有更好的方式能更安全、快捷、私密地将工具的功能传递给所需要的用户。