前言

你是否有这种烦恼？

• 别人在使用你的项目时可能还需要安装各种依赖包？
• 别人在使用你的项目，可能Ta压根都不会安装环境？
• 共用服务机器，偶尔被别人改了依赖包版本，导致运行不起来？

我会发现每次搞这些都要耗费一大堆时间，于是想到以前也有打包过如exe文件直接执行。

一、pyinstaller

PyInstaller是一个用于将Python程序转换为独立的可执行文件的工具。使用PyInstaller，您可以将Python程序打包为单个可执行文件，该文件可以在没有Python解释器的计算机上运行。
以下是使用PyInstaller将Python程序打包为可执行文件的基本步骤：

1、确保已经安装了PyInstaller。如果没有安装，可以使用以下命令进行安装：

pip install pyinstaller

2、打开终端或命令提示符，并导航到包含您的Python程序的目录。

3、运行以下命令来将Python程序打包为可执行文件：

pyinstaller your_script.py

其中your_script.py是您的Python程序的文件名。

4、PyInstaller将在当前目录中创建一个名为dist的文件夹，其中包含生成的可执行文件。在Windows上，可执行文件将具有.exe扩展名，而在Linux和Mac上则没有扩展名。

5、命令查看

pyinstaller --help

• -F：将所有文件打包为一个单独的可执行文件。
• -D：将所有文件打包为一个目录，包含可执行文件和所有依赖的文件。
• -c：将程序与命令提示符结合在一起，以便在命令提示符下运行。
• -d：将调试信息打包进可执行文件中。
• –onefile：将所有文件打包为一个单独的可执行文件。
• -o：指定输出文件的位置。
• -w：打包为窗口文件。
• -i：指定ico。

我最常用的为：

pyinstaller -F -i xxx.ico xxx.py

---

二、实践打包exe

pyinstaller -F -i ./desc/build.ico ppl.py

1、遇坑1：Plugin already registered

依赖一般都会打入，但是其中也有入到坑，比如 pytest

import pytest
from allure_pytest import plugin as allure_plugin
# pytest.main(argv)
pytest.main(argv, plugins=[allure_plugin])  # todo use package

当我打包时需要将 allure_plugin 依赖打入，但是当我在ide中运行又报错，于是只能改为：

import pytest
from allure_pytest import plugin as allure_plugin
pytest.main(argv)
# pytest.main(argv, plugins=[allure_plugin])  # todo use package

pytest.main(argv) 才得以解决，报错如下：
ValueError: Plugin already registered: allure_pytest=<module ‘allure_pytest.plugin’

---

2、遇坑2：OSError 句柄无效

1、打包后执行exe发现以下错误：

Traceback (most recent call last):File "<string>", line 1, in <module>
OSError: [WinError 6] 句柄无效。

后看到是loguru日志模块报错：
也看到了此 issues 但是没有实际解决。

2、于是在运行时添加一个参数表示日志是否用 loguru
默认是用，如果添加参数 --colour=0 则表示不使用loguru。
部分代码改动如下：类 PplLog 打印 print 分别有使用到loguru的方法一致，这样代码改动最小了。

3、打包测试
发现正常了，应该就是这个原因 issues 但貌似没有看到更好的解决办法，只能先这样了。

---

三、总结

• 打包后方便是方便到各种机器可一键运行了，但是你的一些改动可能又得重新打包，或者你看你会遇到各种各样的打包问题，也得花时间去解决。

• 如果是linux、mac等机器下，那可能也得去有台宿主机才可以打包，目前没看到Windows下可以任意打包其它操作系统的。

• 在代码解释器下运行没有问题，但不一定打包后没问题，比如少了依赖等也是比较难排查的。

我的代码地址：
github
gitee