Python 打包 Exe 程序避坑指南

发布时间：2025-11-05 05:58:07 来源：码上建站 作者：数据库

本文转载自微信公众号「Python中文社区」，打包作者杨炳。序避转载本文请联系Python中文社区公众号。打包

写完一个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的WordPress模板名字改回来。

2.缺少导入hook文件

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

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

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

然后放到~\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。即可解决该问题。

四、花式打包

涉及到打包的几个重要参数如下。b2b供应网

五、结语

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

作者：杨炳，心理学者在银行写代码。

相关文章