PyQT5 封装独立程序，优先推荐 pyinstaller，而非 py2app 或者 py2exe。事实上，PyInstaller 封装 Windows 端的 exe 文件也是不错的选择。

这是因为 py2app 等不会将程序环境（如 python 的 frameworks 等），因此并不会封装为一个独立的软件（standalone app），具体表现为仅能在本机正常运行，在别人的电脑上运行会报错。然而 pyinstaller 则封装完整，可在同系统的不同机器上运行。

封装步骤

首先安装工具包：

pip3 install pyinstaller

然后在 terminal 中依次键入:
pyinstaller --windowed --onefile --clean --noconfirm main.py
pyinstaller --clean --noconfirm --windowed --onefile main.spec

其中，如果要自行设计 Mac 系统下的图标的话，那么可以替换第 1 条指令为：

pyinstaller --windowed --onefile --icon=sat_tool_icon.icns --clean --noconfirm main.py

其中图片转换地址为 https://iconverticons.com/online/

而 windows 系统下的图片格式应为 .ico。

调测

一般而言，很少有同学能一次跑通，经常莫名其妙就闪退了或者报错，非常遗憾大家都得根据本机环境进行一些修改。

那么我们到底要调测哪些东西呢？从哪里看我们的报错呢？

STEP 1: 找到 exec 文件

对于 mac 系统来说，方法有两个（其实本质是一个）：

1. 大家双键单击 app 文件选择 show package contents，如下图找到你们的 exec 文件（文件名字是自己起的，主要看文件类型）；

image.png

2. 直接打开 exec 文件（文件名字是自己起的，主要看文件类型）：

   
   
   image.png

STEP2: 使用 exec 文件运行，并查看报错

image.png

如上是正确时候的运行输出，但如果有错，这里会有具体的报错信息，每个人可能不同。对应不同的报错信息，大家可以直接复制黏贴到 google 或者 Bing 国际版中查看，建议优先查阅英文网页。

经历过的坑与解决方案

我来列举一下我们团队历经过的坑。

坑1：没选对当前 python 版本

大多数同学的电脑中都不止一个 python 版本，比如 mac 自己本身默认的是 python 2.7。

注意一定要选对 python 的版本，pyinstaller 一定要存在你当前 project 的 interpreter 对应的 python 版本下。

坑2：各工具包版本不适配

你可能有不同的包冲突、不适配，解决的方法也是类似的。

以我经历的坑为例，我电脑的 pandas 版本比较高，在使用 pyinstaller 时报错“Pandas missing pandas._libs.tslibs.timedeltas.so”，导致在程序运行时终端总是报错。

解决的方法是：以 pandas 为例，手动增加 hook 文件，将 pandas 的 hiddenimports（即 Pandas missing pandas._libs.tslibs.timedeltas.so） 写入。其实很简答的，具体如下：。

STEP 1

找到 pyinstaller 下 hook 文件所在地。鉴于我们使用了 pip3 下载 pyinstaller，我们可以通过 pip3 的相关指令具体方法为：

    pip3 show pyinstaller

在我的本地机器中，我的 hooks 文件夹地址在于 /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/PyInstaller

STEP 2

在 hook 文件夹中手动增加 hook-pandas.py 文件，在文件中手动写入：hiddenimports = ["XXXX"]，其中 XXX 是指你在运行 exec 文件中报错缺失的那个 module 的名字，对着抄写即可。

比如我的情况为写入：

hiddenimports = ['pandas._libs.tslibs.timedeltas']

参考链接