pyinstaller 打包避坑指南之一

引子

部门需要对 3 个野外工作队的活动进行管理，要求野外工作队随时使用手机对工作内容进行拍照上传，照片中需要采集 GPS 位置信息，每个工作队每天要上传上百张照片，任务完成时采集了 1 万多张照片，需要整理这些照片的 Exif 信息，尤其是位置信息到数据库中，显然，人工一张一张地读取这些照片的 Exif 信息，并记录下来的工作量甚至超过了野外工作，是难已接受的。

于是就想到：能不能用 python 写一段代码，批量自动读取这些照片的 Exif 信息并保存到 csv/xlsx 中呢？

python 的 ExifRead 包提供了这方面的功能，经过几天的折腾，python 脚本基本完成。用它读取几千张照片的 Exif 信息，几分钟时间。

但是，部门其他人的 PC 上都没有 python 环境，更不会直接使用这个脚本，就想到能不能写一个 GUI 界面，并把脚本打包成 exe 文件给同事，傻瓜式操作，一键完成呢？

于是就用 wxPython 实现了一个GUI，用 pyinstaller 打包。

本以为用 pyinstaller 打包应该是比较简单的事，想不到偏偏在 pyinstaller 上踩了无数的坑：找不到模块、闪退、停留在命令行窗口、生成的exe文件不能运行、…等等，差不多都遇到了。

搜索、拜读网文、思考、摸索，一番折腾终于顺利地完成了打包。我将系统地总结一下各种问题产生的原因及解决办法。

先放上打包后的小程序的界面炫一下：

为什么选择 pyinstaller？

pyinstaller是目前应用最多的python打包工具，具有以下优点：

• 跨平台，支持 Windows, GNU/Linux, Mac OS X, FreeBSD, Solaris 和 AIX.
• 输出的可以是单一目录, 也可以是一个单独的打好包的可执行文件。
• 智能支持python的第三方模块，如PyQt，外部数据文件等
• 支持EGG格式文件
• 可执行文件可以用UPX压缩, 二进制压缩方式
• 支持控制台和视窗两种方式。
• 可以选择exe文件的图标

推荐的打包环境

我的操作系统和python环境如下：

• windows 10, 64bit;

• Anaconda 3 平台，默认路径安装的 python，安装路径是“C:\Users\username\anaconda3”;

• 创建了如下图的虚拟环境：
  

• 程序脚本是在`jupy2’ 虚拟环境下写的，该环境安装的是 python 3.8.8。

强烈建议参照如下步骤搭建一个用于打包的 python 环境：

1. 查看你开发 python 脚本的 Python 版本，比如我的是 python3.8.8；
2. 下载相同版本的 python 安装包；
3. 安装到非系统盘，我是安装到 “D:\python388"；下面我将以此为例；
4. 安装时记得选择将路径添加到系统环境变量中。

我们将在这个 python 环境中安装 pyinstaller，并打包 python 脚本。我们且把这个环境称为：打包环境。

这样做，打包经常遇到的问题的多数就已解决。比如，避免生成的包太大。

安装 pyinstaller

在资源管理器中，在 "D:\python388"目录的空白处，shift + 右键菜单，选择”在此处打开 powershell 窗口“。

运行：

pip install pyinstaller

完成 pytinstaller 的安装。

下一篇，将介绍在”打包环境“中仅安装程序必需的包，保证生成的包不会很大。我直接在开发环境中打包生成的包竟然超过800MB。按照这个方法只有 30 多 MB。

有任何问题，欢迎到 python草堂群 交流。