Python打包exe程序避坑指南

开发 后端
本人也是在经历了多次的打包失败和成功的经历之后,觉得pyinstaller的成功率最高,所以有必要针对pyinstaller写一篇避坑指南。

 [[398094]]

写完一个python程序之后,如何才能快速地将代码分享给别人,尤其对于初学者来说,能把自己的代码包装成一个exe程序并传递到别人电脑上运行,那是一件非常有成就感的事。好在python自带简易打包程序,让很多人能过一把当程序员的瘾。目前流行的打包库就有py2exe、pyinstaller和cx_Freeze。

但python的运行环境复杂,编写的程序往往是借助了很多附加的功能库来实现,对简单的打包会造成一定困难。本人也是在经历了多次的打包失败和成功的经历之后,觉得pyinstaller的成功率最高,所以有必要针对pyinstaller写一篇避坑指南。

一、安装

使用python的pip安装,在cmd窗口,使用pip install pyinstaller,即安装完成。然后配置好环境变量。

二、使用

例如在程序6.py所在文件夹打开cmd窗口。一般输入pyintaller -F **.py(命令符的具体含义在下文中解释),回车即开始打包。顺利的话,会出现打包成功的反馈,如下图,这时,就说明文件已经打包完成了。dist文件夹里面就放着打包完的exe程序,使用时剪切出来就行了。如果运气好或者本身程序比较简单,那这个exe就能在任何电脑运行了。

但往往没这么容易,pyinstaller在使用中有很多坑,打包的开始,也是修补的开始。

三、遇坑填坑

1.文件路径中不能出现中文

否则会在打包过程中直接出现如下报错。这时只要把所在文件夹和程序名字改成英文或者数字重新打包即可。可以打包完再将exe的名字改回来。

2.缺少导入hook文件

有时即使打包成功了,在运行exe时候,还是会有报错并闪退。

如果报错为:FileNotFoundError: [Errno 2] No such file or directory:……

那是缺少hook文件,要在pyinstaller的安装路径里的hook增加一个自定义的hook。hook文件的命名规范为: hook-【库名】.py。例如以我在打包程序中用了结巴分词这个功能库为例,那我要建立一个hook-jieba.py,并写入: 

  1. from PyInstaller.utils.hooks import collect_data_files  
  2. datas = collect_data_files("jieba") 

然后放到~\Lib\site-packages\PyInstaller\hooks中去,再次运行pyinstaller打包既可解决该问题。

3.缺少导入功能库模块

如果报错为 no moduler named “pandas._libs.skiplist”,那就要手动import库,解决方法打开生成的spec文件,找到 hiddenimports=[],加上要添加的库,将其改动如下,hiddenimports=["pandas._libs.skiplist"],然后删除dist里面的exe文件,重新用spec文件打包,pyinstaller **.spec。即可解决该问题。

四、花式打包

涉及到打包的几个重要参数如下。

  •  -F,将所有内容打包到一个exe中,方便发送,一般都使用这个参数。
  •  -c,此为windows系统的默认选项,使用这个参数,运行时会有一个黑窗控制台。
  •  -w,使用这个参数,运行时不会出现黑窗控制台。
  •  -i  使用这个参数用于生成自定义图标的exe,在这后面要加上ico图片的地址。例如,pyinstaller -i D:\icons\demo.ico **.py

五、结语

将程序打包成exe发送出去或者供用户下载,是一个比较传统的传播方式,并且比较笨重,其实用简单的H5或者小程序就能实现一样的效果,对用户而言也更方便,也是朝着轻应用的方向发展。此外,对于专业用户还能通过github和api等方式传播。随着网络观念的深入人心和5G时代到来,相信有更好的方式能更安全、快捷、私密地将工具的功能传递给所需要的用户。 

 

责任编辑:庞桂玉 来源: Python中文社区(ID:python-chia)
相关推荐

2021-05-07 21:53:44

Python 程序pyinstaller

2018-03-26 11:14:13

程序猿bug代码

2024-04-24 13:45:00

2024-04-03 12:30:00

C++开发

2021-02-26 00:46:11

CIO数据决策数字化转型

2020-06-19 11:20:17

开发避坑支付宝

2020-06-12 11:03:22

Python开发工具

2021-02-22 17:00:31

Service Mes微服务开发

2022-03-04 18:11:16

信服云

2023-05-24 10:06:42

多云实践避坑

2021-04-28 09:26:25

公有云DTS工具

2020-12-16 10:00:59

Serverless数字化云原生

2018-01-20 20:46:33

2020-09-13 09:19:10

LinuxPython3.6

2019-02-12 15:07:42

屏幕参数PC

2019-04-24 17:45:24

微服务容器青云

2024-02-20 08:51:56

PythonFlask工具

2020-08-26 07:37:25

Nacos微服务SpringBoot

2023-11-01 15:32:58

2011-12-07 12:01:31

ibmdw
点赞
收藏

51CTO技术栈公众号