Python 进阶必学库:Pyinstaller 使用详解
HackPython 致力于有趣有价值的编程教学
简介
当我们希望将自己编写好的程序传送给他人使用时,如果对方没有安装 Python 环境就无法使用程序了,我们难以让每个使用者都安装 Python 环境,是否可以在不必安装 Python 环境的前提下使用 Python 程序呢?????
可以使用 Pyinstaller 将程序打包,然后再分享给其他人使用,他人使用只需双击运行打包好的程序。
可以通过 pip 来安装,命令如下:
pip install pyinstaller
使用
pyinstaller 最重要的两个参数就是 -F 与 -D 参数。
使用 - F 参数, pyinstaller 会将 python 程序打包成单个可执行文件。
使用 - D 参数, pyinstaller 会将 python 程序打包成一个文件夹,运行程序时,需要进入该文件夹,点击运行相应的可执行程序。
为了美观,还可以通过 - i 参数指定打包程序的图标 (icon),但这个命令只能在 Windows 平台下生效,此外还可以使用 - n 参数指定生成打包文件的名称。
如果你使用了 PyQt5 或 tkinter 开发了界面,通常不会希望程序运行时弹出 cmd 命令行,此时就可以使用 - w 参数。
????简单总结一下:
-F:打包 Python 程序为单个可执行文件 -D:打包 Python 程序为一个文件夹 -i:生成图标,只适用于 Windows 平台 -n:指定打包后生成文件的名称 -w:禁止命令行弹出
综上所述,最常见的命令为:
pyinstaller -i xxx.ico -n xxx -w -D xxx.py
-i 参数后必须接 .ico 结尾的图标文件 -D 或 -F 后必须接 python 程序的入库程序,常见情况为 main.py
对应依赖比较多的程序,建议使用 -D, -F 更适合单文件的 py 脚本。
简单原理
打包时,pyinstaller 此时会生成相应的 spec 文件,大体流程如下:
????1、在脚本目录生成 xxx.spec 文件 (取决于 -n 参数,没传,则与 xxx.py 同名为 xxx);
????2、创建一个 build 目录;
????3、写入一些日志文件和中间流程文件到 build 目录;
????4、创建 dist 目录;
????5、生成可执行文件或文件夹到 dist 目录;
此时,进入 dist 目录就可以看见自己的打包文件了。
击 nameauto.exe 文件,效果如下:
效果如下:
这是一个利用 tkinter 构建的程序。
注意事项
Pyinstaller 是跨平台的,但并不是指其生成应用是跨平台的,而是 Pyinstaller 本身是跨平台的,在 Windows 平台下,可以打包出 exe 文件。
????避免打包后,包文件过大
为了避免 Pyinstaller 打包后程序或文件夹过大,如:几百 KB 的程序打包后编程 500M 左右的程序,在引用包时,尽量使用 from ... import ... 语句,这是因为 Pyinstaller 打包的路径其实是将 python 解释器以及项目中使用的库直接复制过来,所以如果你没事就别 import... ,那么 Pyinstaller 会将整个模块复制过去,此时打出来的包就会很大。
????考虑路径问题
使用 python 时,要养成使用 os.path.join 的习惯,这不仅可以避免跨平台的路径坑 (windows 路径表达与类 Unix 是不同),又可以在打包时不会出现相对路径的问题,很多 python 程序员编写路径喜欢使用 + 号来链接路径,这会增加项目的维护成本
pyinstaller 打包的项目遇到路径都使用 os.path.join 则可
????外部数据问题
虽然在上节中,提及了使用外部数据时,可以自定义 spec 文件中的 datas 字段,但我更常用的做法是直接将数据复制过去,不去修改 datas。
比如我的项目中依赖 config 文件夹下的配置文件,执行将 config 文件夹整体直接复制到打包好的文件夹中则可
????闪屏结束
如果是简单的程序,可能会出现运行可执行程序后出现一闪而过的情况,这种情况下要么是程序运行结束(比如直接打印的 helloWorld),要么程序出现错误退出了。
这种情况要么通过 input () 函数捕捉输入自己主动结束程序,要么就在 cmd 下运行 exe 文件,从而通过 cmd 看到效果
结尾
掌握了 Pyinstaller 后,你就可以将任意程序打包发送给他人了,最后欢迎学习 HackPython 的教学课程并感觉您的阅读与支持。
????????