Pyinstaller（Python打包为exe文件）

 

需求分析：

python脚本如果在没有安装python的机器上不能运行，所以将脚本打包成exe文件，降低脚本对环境的依赖性，同时运行更加迅速。

当然打包的脚本似乎不是在所有的win平台下都能使用，win7有一部分不能使用，我在win10能够很好的运行。

准备：  

pyinstaller（http://www.pyinstaller.org/） 首先还是去官网看支持的python版本，不然会很尴尬的

#安装方法1：
#安装pyinstaller和pywin32
#使用一下命令将自动安装两个包,在cmd用pip命令

#pip install -i https://pypi.douban.com/simple/ pyinstaller（豆瓣源）

安装方法二：

pip install pyinstaller   （会自动下载future,pywin32,pyinstaller）

如何使用Pyinstaller

方法一：
1.cmd到/python/scripts 找到pyinstaller.exe
2.输入命令

1
pyinstaller.exe -F path:demo.py

方法二：
1.进入pyinstaller的解压包，输入命令
2."python pyinstaller.py -F path:demo.py"
从cmd最后一行输出可查找到生成的文件

12468 INFO: Appending archive to EXE D:\Documents\Downloads\PyInstaller-3.2\down
load\dist\download.exe

 

后记：

1.程序设置自定义图标：pyinstaller -F -i ico_path  py_path 

首先需要下载一张正常的ico，不能用直接修改后缀的。

下载图片：　　  https://www.easyicon.net

图片改为ico:　　http://www.ico.la/

输入命令 pyinstaller -F -i "demo.ico" "main.py"

2.报错提示：

pyinstaller -F -i "demo.ico" "main.py" 命令格式一定是先图标路径，再程序路径。

路径最好为英文，没有中文字符；脚本名称里没有特殊字符如 .

使用utf8编码

图标文件必须是正常格式，不能直接更改后缀。

tuble index out of range ---》pyinstaller版本尚未支持python的版本

3.窗口程序

使用 pyinstaller -F -w  -i ico_path  py_path ，这样脚本不会弹出命令窗，前提是用了GUI库. 

4.导入模块问题

pyinstaller -F -w  -i  --hidden-import queue ico_path  py_path 加上选项

 

一、安装Pyinstaller

1、安装pywin32

    • 下载安装文件：查找到跟自己适用的python版本及window系统版本匹配的 pywin32 ，下载后安装 

    • 使用pip命令安装：pip install pywin32

2、安装Pyinstaller

    • 使用pip命令安装：pip install PyInstaller

二、使用Pyinstaller

1、使用下载安装的方式安装的Pyinstaller打包方式

将需要打包的文件放在解压得到的Pyinstaller文件夹中，打开cmd窗口，把路径切换到当前路径打开命令提示行，输入以下内容（最后的是文件名）：

    • python pyinstaller.py -F myfile.py

2、使用pip方式安装的Pyinstaller打包方式

打开cmd窗口，把路径切换到文件所在路径(文件随便放在哪里都行)打开命令提示行，输入以下内容（最后的是文件名）：

    • pyinstaller -F myfile.py

3、输入参数的含义

  • -F 表示生成单个可执行文件

  • -w 表示去掉控制台窗口，这在GUI界面时非常有用。不过如果是命令行程序的话那就把这个选项删除吧！

  • -p 表示你自己自定义需要加载的类路径，一般情况下用不到

  • -i 表示可执行文件的图标

三、注意事项

  • 文件中使用了第三方库的打包方式

在打包之前务必找到第三方库的包，把包复制到到跟myfile.py同目录下，然后再使用以上2种方式打包，否则会打包失败或者即使打包成功，程序也会闪退。

下面演示一下使用了第三方库的打包方式：

    • 找到第三方库的包，如使用了requests，可以使用查找的方式，找到这个包在哪里，然后把它复制到myfile.py同目录下

Pyinstaller（Python打包为exe文件）_经验分享

    • 把包文件复制到myfile.py目录下

Pyinstaller（Python打包为exe文件）_经验分享_02

 

    • 给程序换图标的方法
      • 输入命令中添加一个-i tubiao.ico(图标的相对路径)。如图：

Pyinstaller（Python打包为exe文件）_经验分享_03

四、exe文件生成

  • 如果程序打包过程没有报错，则会生成3个文件夹（有时候是2个），其中名为dist的文件夹中会有一个myfile.exe文件，运行一下，如果没有问题就打包成功，可以把这个exe文件单独拿出去用，其他的生成的文件夹可以删掉了。

　　　　 Pyinstaller（Python打包为exe文件）_经验分享_04

 

 

 

一、pyinstaller相关参数

 

-F, –onefile 打包一个单个文件，如果你的代码都写在一个.py文件的话，可以用这个，如果是多个.py文件就别用
-D, –onedir 打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，我个人比较推荐这样，代码易于维护
-K, –tk 在部署时包含  TCL/TK
-a, –ascii 不包含编码 . 在支持 Unicode的 python 版本上默认包含所有的编码 .
-d, –debug 产生 debug 版本的可执行文件
-w,–windowed,–noconsole 使用 Windows 子系统执行 . 当程序启动的时候不会打开命令行 ( 只对 Windows 有效 )
-c,–nowindowed,–console

使用控制台子系统执行 ( 默认 )( 只对 Windows 有效 )

pyinstaller -c  xxxx.py

pyinstaller xxxx.py --console
-s,–strip 可执行文件和共享库将 run through strip. 注意 Cygwin的 strip 往往使普通的 win32 Dll 无法使用 .
-X, –upx 如果有 UPX 安装 ( 执行 Configure.py 时检测 ), 会压缩执行文件 (Windows 系统中的 DLL 也会 )( 参见 note)
-o DIR, –out=DIR 指定 spec 文件的生成目录 , 如果没有指定 , 而且当前目录是 PyInstaller 的根目录 , 会自动创建一个用于输出 (spec 和生成的可执行文件 ) 的目录 . 如果没有指定 , 而当前目录不是 PyInstaller 的根目录 , 则会输出到当前的目录下 .
-p DIR, –path=DIR 设置导入路径 ( 和使用 PYTHONPATH 效果相似 ). 可以用路径分割符 (Windows 使用分号 ,Linux 使用冒号 ) 分割 , 指定多个目录 . 也可以使用多个 -p 参数来设置多个导入路径，让pyinstaller自己去找程序需要的资源
–icon=<FILE.ICO>

将 file.ico 添加为可执行文件的资源 ( 只对 Windows 系统有效 )，改变程序的图标  pyinstaller - i  ico路径 xxxxx.py
–icon=<FILE.EXE,N> 将 file.exe 的第 n 个图标添加为可执行文件的资源 ( 只对 Windows 系统有效 )
-v FILE, –version=FILE 将 verfile 作为可执行文件的版本资源 ( 只对 Windows 系统有效 )
-n NAME, –name=NAME 可选的项目 ( 产生的 spec 的 ) 名字 . 如果省略 , 第一个脚本的主文件名将作为 spec 的名字

二、pyinstaller爬坑总结

第一次玩pyinstaller，遇到了不少坑，在这里总结一下，以免日后再次掉坑里。

1、先从这次写的工具再说吧，写这个工具的初衷是由于自己手工造数据文件花了很长时间，然后就想着写个工具来解决这个问题（也是想锻炼下自己的代码能力，哈哈哈），利用下班晚上以及周末写了一周大概写出来了。

这个工具是个扫码支付文件生成工具，主要是解决手工造文件数据，有两个功能，一是基础扫码文件生成功能、二是大批量扫码文件生成功能，同时加上了用户auth控制。

在这里提醒大家，在代码里面尽量不要用import，能from.....import....就尽量用这个，因为如果是import的话，在打包的时候，会将整个包都打包到exe里面，没有意义的增大了工具的大小！

大概框架如下：

Pyinstaller（Python打包为exe文件）_经验分享_05

2、Gui开发完毕后，开始研究pyinstaller，也翻阅了论坛关于pyinstaller的相关用法，这里总结下我的工具的打包步骤

2.1、先下载pyinstaller，我比较懒，就直接用pip install pyinstaller，等待自动安装

2.2、在代码的路径下进行cmd，就直接跳转到该路径的cmd界面，切记路径中不要有中文

Pyinstaller（Python打包为exe文件）_经验分享_06

2.3、先用后台模式生成工具exe，命令为pyinstaller xxxx.py文件，主要目的是为了看报错信息，解决了报错后，再生成完整版的工具

tip：由于我的代码是存在依赖的，即多文件的，而非所有代码都在一个文件中的，所以我在这里没有使用-F，刚开始玩的时候不知道，老是用了-F生成了单文件的，没有生成依赖，老是不成功，各位朋友切记！

下图为命令生成的日志，红框部分则为exe工具生成的路径，如果在日志中只有info信息的话，说明打包过程没有问题

Pyinstaller（Python打包为exe文件）_经验分享_07

Pyinstaller（Python打包为exe文件）_经验分享_08

2.4、找到生成的exe文件，运行exe（生成的exe文件都会在dist目录下）

Pyinstaller（Python打包为exe文件）_经验分享_09

运行时，我遇到了以下的报错信息，是在dist找到相关的图片资源，所以需要把所有关于工具所需的资源（包含图片以及依赖的.py文件都放进dist下的项目目录中）

Pyinstaller（Python打包为exe文件）_经验分享_10

Pyinstaller（Python打包为exe文件）_经验分享_11

2.5、再次运行exe，此时运行成功，说明工具打包成功

Pyinstaller（Python打包为exe文件）_经验分享_12

2.6、重新生成exe工具，去掉后台模式以及更换掉图标

给大家推荐一个图标获取地址，里面ico蛮多的： easyicon

下载了自己心仪的ico后，用-i+ico路径来替换默认ico，这次重新生成exe工具，命令为pyinstaller -i ico路径 -w xxxx.py

Pyinstaller（Python打包为exe文件）_经验分享_13

再将需要的图片资源和代码文件放到dist下的项目文件夹中

Pyinstaller（Python打包为exe文件）_经验分享_14

2.7、运行exe，能够打开则表示pyinstaller打包exe成功

Pyinstaller（Python打包为exe文件）_经验分享_15