python封装（pyinstaller）

最新推荐文章于 2025-07-11 15:22:31 发布

张念

最新推荐文章于 2025-07-11 15:22:31 发布

阅读量1.4w

点赞数 6

CC 4.0 BY-SA版权

分类专栏：工具文章标签： python 封装

本文链接：https://blog.youkuaiyun.com/qq_25867649/article/details/79614671

工具专栏收录该内容

11 篇文章

订阅专栏

本文介绍如何将Python程序封装成Windows和Mac OS下的独立可执行文件，包括使用pyinstaller工具的过程、常见问题及解决方案。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

windows 下编写控制台程序后，会生成exe的可执行程序，创建工程最后都会生成可执行程序，python工程都是python调用各种模块，执行起来也不方便，所以这里讲一下python封装exe文件过程！

windows 系统（按照我自己环境）：

首先我们拿到python工程文件后，必须保证程序可以正常执行，才能在此环境中进行封装，不然封装成功了，执行时会报错，提示有些模块没有导入

1. 打开cmd 运行 pip install pyinstaller ：

2. 安装时，报错，具体就是pywin32版本不对，需要重新安装pywin32：

3. 打开网址 https://www.lfd.uci.edu/~gohlke/pythonlibs/ ，选择pywin32 下载whl文件，注意要和电脑匹配

4. 进入下载好的目录下，运行pip install pywin32.whl

5. 再次安装pyinstaller，安装成功，准备打包

打包：

1. 确定程序入口（相当于程序的主函数）

2. 通过 cd 命令进入main.py文件所在路径

3. 执行命令： pyinstaller -F -wmain.py --hidden-import=pandas._libs.tslibs.timedeltas可以看到相应目录生成build和dist文件夹 build文件夹没用可以删除

4. 将platforms文件夹放到exe文件同级目录，运行exe（这里platforms 里面是pyqt调用的动态库文件）

5. 打开exe，成功

Mac osx系统

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

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

封装步骤

在 terminal 中依次键入:

pip3 install pyinstaller
pyinstaller --windowed --onefile --clean --noconfirm main.py
pyinstaller --clean --noconfirm --windowed --onefile main.spec

调测

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

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

STEP 1: 找到 exec 文件

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

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

image.png

直接打开 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

找到 python frameworks 下 hook 文件所在地

STEP 2

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

比如我的情况为写入：

封装windows时，很顺利，mac系统封装碰到了各种问题，还是不太了解里面的运行机制，以后再深入了解把！