使用Pyinstaller打包成EXE文件

pyinstaller能够在Windows、Linux等 *** 作系统下将Python脚本打包成可直接运行程序。使Python脚本可以在没有安装Python的环境中直接运行，方便共享。

python 2.7.12 + Windows7

1.待转换的.py文件绝对路径最好不要包含中文字符。容易出现一些莫名其妙的问题。

2.python中需要有.py文件中用到的第三方库。否则在转换后的.exe文件中会出现不符合预期的结果。

1.配置pip镜像源。

在用庆族户家目录下创建pip目录和pip.ini文件。方法如下

step1： 获取HOMEPATH变量对应的路径，执行 set HOMEPAT H也可以执行 echo %HOMEPATH% 获取。

上述结果说明用户家目录HOMEPATH对应的路径为C:\Users\Administrator。

step2： 在C:\Users\Administrator目录下创建pip目录，斗启并在pip目录下创建pip.ini文件。如果已经有pip目录和pip.ini文件，跳过。 特别说明的是，pip.ini文件的后缀是.ini，注意隐藏扩展文件誉销弊名可能造成的影响。 在pip.ini文件中添加相关内容并保存:

step3： 测试pip工具，确认是否能够自动安装第三方库，如使用pip自动安装Pexpect类库。

step4： 进入python工具，执行import pexpect导入模块命令，没有报错说明pip自动安装pexpect库成功。

step5： 结束安装，后续安装第三方库就可以在任意路径下直接执行pip install ${PackageName}进行安装。

2.打开cmd命令行窗口，输入 pip install pyinstaller ，安装pyinstaller库。

3.确认pyinstaller安装结果，位于c:\Python27\Scripts路径下。执行 where pyinstaller 查看

pyinstaller [options] script

例如： pyinstaller -F myscript.py

options常用选项说明：

pyinstaller其实就是把python解释器和脚本打包成一个可执行文件，和编译成真正的机器码是完全两回事。所以打包不一定会提高运行效率，可能会降低运行效率，但是好处是在运行者机器上不用安装python和脚本所依赖的库。

输入指定的脚本后，首先pyinstaller会分析该脚本所依赖的其他依赖，然后进行查找、复制，把所有相关的依赖都收集起来并进行加密处理，包括python解释器，最后把这些文件放在一个目录下，或者打包到一个可执行文件，然后就可以直接运行所生成的可执行文件。

需要注意的是，使用pyinstaller打包生成的可执行文件，只能再和打包机器系统相同的环境下运行。32位python环境打包的程序可以运行在32/64位windows系统上。64位python环境打包的程序只能运行在64位windows系统上。所以如果想打包程序的话，建议使用32位python环境打包。

1.确认待转换的.py文件可正确运行，不存在语法错误。如ccc.py

2.执行 pyinstaller -F ${Python脚本名} 完成文件转换。.exe文件生成的绝对路径会在倒数第二行显示，通常位于当前目录下dist所在目录下。转换后的.exe文件名与python文件名相同。如下图所示

1.如果Python脚本使用到了第三方库，如何打包？

方法一：将第三方库对应的包复制到待打包python脚本的同目录下，再执行打包命令。

方法二：pyinstaller.exe -F 路径\文件名.py 路径\文件名.py

2.我的python脚本主要是命令行输出，但是程序执行完就退出无法查看相关信息，如何处理？

在python脚本最后一行添加命令：os.system('pause') 或者 raw_input('Press enter any key to exit...')

3.我想给我的打包后的执行程序换个图标，如何处理？

使用参数-i。如命令：pyinstaller -F -i tupian\qq.ico ccc.py。文件后缀名必须是.ico

4.程序运行出现CMD窗口，如何去除？

带上参数-w即可。pyinstaller.exe -F call_login.py -w （-w表示去掉控制台窗口显示）

5.pip配置镜像源参考

PyInstaller是一个用来将Python程序打包成独立可执行软件的工具，支持 Windows、Linux 和 Mac OS X。生成的可执行软件在没有Python的环境中可以直接运行，方便软件分发，进一步降低使用成本，提升使用效率。

下面演示如何使用 PyInstaller 将程序打包成Windows下的exe软件。

使用pip的方式进行安装，这样可以自动安装其他依赖库。

如果pip还未安装，请参考我的另一篇文章《 Python pip包管理工具 》

在cmd命令行控制台或者VS Code内置的终端输入命令行生成应用，首先将当前路径切换到Python程序所在的路径（如下示例的SubOcr.py文件在python文件夹下的SubOcr文件夹内），然后输入生成应用的命令。

命令执行成功后在 I:\work\python\SubOcr\dist 文件夹下生成了SubOcr文件夹，里面包含了SubOcr.exe文件。整个SubOcr文件夹就是一个绿色软茄老件，随便移动到任何位置都可运行。

实际上在用pyinstaller命令时会在Python程序的所在路径生成一个后缀为spec的同名文件，然后根据此文件的配置生成应用，这就是PyInstaller的原理。这样做的好处是spec保存了生成应用的配置，每次重新生成应用时可以省略指定参数，尤其是指定了其他的资源、程序库时。我们可以通过以下命令先生成spec文件。

pyi-makespec的命令参数跟pyinstaller的相同，在生成spec文件后可以对其部分选项进行编辑（可以用VS Code或自带的记事本编辑颤中升），添加更多参数，然后再用pyinstaller命令生成应用。

spec文件的主要选项：

上面示例的SubOcr用到了opencc和opencv-python，其中opencc下的数据文件和opencv-python下的dll文件在生成应用时不会自动导入（缺少这些文件应用无法正常使用），因此需要在spec文件中指定路径。对spec文件的修改如下：

以上便是PyInstaller打包Python程序的全过程，如果在此过程中遇到问题，可以在评论区留言，定当知无不言，言无不培枯尽。

---