Pyinstaller (python打包为exe文件)

Posted 2021-02-14 Gloo

需求分析：

• python脚本如果在没有安装python的机器上不能运行，所以将脚本打包成exe文件，降低脚本对环境的依赖性，同时运行更加迅速。
  
• 当然打包的脚本似乎不是在所有的win平台下都能使用，win7有一部分不能使用，我在win10能够很好的运行。

准备：

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

安装：

需要安装pyinstaller和pywin32
使用以下命令将会自动安装两个包，在cmd用pip命令

• 方法一：

pip install -i https://pypi.douban.com/simple/pyinstaller(豆瓣源)

• 方法二：

pip install pyinstaller(会自动下载future, pywin32, pyinstaller)

运行方式：

1、cmd进入到安装pyinstaller的python环境下的/python/scripts目录 找到pyinstaller.exe。
2、执行命令：

pyinstaller.exe -F path:demo.py

案例：

将D:pythonProjectpython3.5september19calculator.py文件打为exe可执行文件

# 1.cmd进入到安装了pyinstaller的目录下
D:pyutil>F:  # 切换盘符
F:>cd pyenv/pyutil/scripts  # 切换目录
# 执行命令 -F 生成one-file的程序
F:pyenvpyutilScripts>pyinstaller.exe -F D:pythonProjectsPython3.5september19calculator.py
# 执行成功后会当当前目录下生成一个dist目录并在dist目录上生成一个exe文件
11445 INFO: Appending archive to EXE F:pyenvpyutilScriptsdistcalculator.exe

各参数含义

通用参数

参数名	描述	说明
-h	显示帮助	无
-v	显示版本号	无
--distpath	生成文件放在哪里	默认：当前目录的dist文件夹内

与生成结果有关参数

参数名	描述	说明
-D	生成one-folder的程序（默认）	生成结果是一个目录，各种第三方依赖、资源和exe同时存储在该目录下
-F	生成one-file的程序	生成结果是一个exe文件，所有的第三方依赖、资源和代码均被打包进该exe内
-n	生成.exe文件和.spec的文件名	默认：用户脚本的名称，即main.py和main.spec

Windows和Mac特有的参数

参数名	描述	说明
-c	显示命令行窗口	与-w相反，默认含有此参数
-w	不显示命令行窗口	编写GUI程序时使用此参数有用。
-i	为main.exe指定图标	pyinstaller -i beauty.ico main.py

详情请参考：PyInstaller各参数含义

后记

• 程序自定义图标：

pyinstaller -F -i ico_path py_path

首先需要下载一张正常的ico，不能直接修改后缀的。
下载图片：https://www.easyicon.net
图片改ico：http://www.bitbug.net
输入命令

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

• 报错提示：
  路径最好为英文，没有中文字符；脚本名称里没有特殊字符如.
  使用utf-8编码
  图标文件必须是正常格式，不能直接更改后缀。
  tuble index out of range --> pyinstaller 版本未支持的python版本
• 窗口程序
  使用 pyinstaller -F -w -i ico_path py_path ，这样脚本不会弹出命令窗，前提是用了GUI库.

几个非常重要的问题

• 命令使用pyinstaller和pyinstaller.exe结果都是一样的
• -w是不显示命令窗口， -i 图标文件的路径 这是改变图标的，但是我发现只能改变任务栏里的和命令窗口的图标，并不能改变exe文件的图标。另外这些参数要加载pyinstaller和路径中间。
• 有一些代码需要调用一些图片和资源文件的，这是不会自动导入的，需要你自己手动复制进去才行。不然exe文件运行时命令窗口会报错找不到这个文件。
• 也是最坑的一点。就是当你使用错误的参数去打包或者打包到一半中断，等等此类运行到一半没了的情况。会导致你原来的py文件变成一个0KB的空文件。里面的代码会全部消失！！！所以以后需要有个良好的习惯，就是复制一份代码出来，用这个副本进行打包。并且参数出错，或者打错了导致失败时，检查下副本文件的py文件是否还存在再继续重新打包，不然打出来的就是空的文件，自然一直闪退，因为压根没内容。
• 写代码的时候应当有个良好的习惯，用什么函数导什么函数，不要上来import整个库，最后你会发现你一个100KB的代码打包出来有500MB，全是库，简直无语
• pygame代码调试的时候要用quit（）不然程序结束时会崩溃。但是直接运行py文件就不需要这个函数。这个我们之前的文章也提到过了。但是这里当我使用-w做成无窗口的程序后，一结束发现报错，暂停后发现报的是找不到quit（）函数。可见这个函数其实是一个很让人无语的函数。一方面pygame官方网上说结束程序的时候需要加入这个函数。另一方面其实在正在运行时都不需要甚至会报错。虽然也不影响运行，但是弹个窗口出来说 什么不fail to execute总是让别人觉得你是个lowb。所以，调试的时候加一下，到时候execute的时候去掉。