需求分析:
- 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:\pythonProject\python3.5\september19\calculator.py文件打为exe可执行文件
# 1.cmd进入到安装了pyinstaller的目录下
D:\pyutil>F: # 切换盘符
F:\>cd pyenv/pyutil/scripts # 切换目录
# 执行命令 -F 生成one-file的程序
F:\pyenv\pyutil\Scripts>pyinstaller.exe -F D:\pythonProjects\Python3.5\september19\calculator.py
# 执行成功后会当当前目录下生成一个dist目录并在dist目录上生成一个exe文件
11445 INFO: Appending archive to EXE F:\pyenv\pyutil\Scripts\dist\calculator.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的时候去掉。