1.说明
我们写出来的Python代码需要配合解释器才能执行,并不能像C、Java等语言一样编译成可执行程序,所以在没有安装Python环境的电脑上就不方便运行py代码,为了解决这个问题,我们可以借助pyinstaller、cx_Freeze、nuitka等工具对Python代码打包,它们的优缺点可以自行百度,我这里介绍一下pyinstaller的用法
2.安装pyinstaller
使用pip安装就行,个人建议在一个新的干净的虚拟环境操作
pip install pyinstaller
3.打包命令
最简单的命令是pyinstaller py文件
,在cmd或终端执行一下就能打包了,但有很多参数我们可以留意一下
选项 | 说明 |
---|---|
-h | 帮助说明 |
-v | 当前版本 |
-D | 打包到一个文件夹(默认) |
-F | 打包到一个文件,不推荐,除非你的代码没有引用自定义模块 |
-w | 程序运行时隐藏cmd窗口(针对Windows) |
-c | 程序运行时显示cmd窗口(针对Windows)(默认) |
-n | 生成的可执行文件名,默认与代码文件同名 |
-i | 可执行程序的图标,window系统用ico文件,Mac系统用icns文件 |
–distpath | 打包后保存的路径,默认是./dist |
–workpath | 打包时工作路径,默认是./build |
–specpath | spec文件的路径,默认是当前文件夹 |
–clean | 自动清理缓存文件 |
–upx-dir | upx程序路径,如果有的话 |
–add-data SRC;DEST | 非二进制文件打包路径,Windows系统用分号分隔,类Unix系统用冒号分割 |
–add-binary SRC;DEST | 二进制文件打包路径,Windows系统用分号分隔,类Unix系统用冒号分割 |
–log-level | 打包时的日志等级 |
4.命令举例
全部参数使用默认设置
pyinstaller main.py
打包为单个可执行程并隐藏控制台
pyinstaller -F -w "E:\python_test_project\main.py"
指定可执行文件的图标
pyinstaller -F -w -i E:\python_test_project\images\test_ico.ico E:\python_test_project\main.py
使用upx进行压缩并且添加文件
pyinstaller -F -w --clean --upx-dir "D:\UPX" E:\python_test_project\main.py
添加文件夹到程序里
pyinstaller -D -w --add-data "E:\repository\python_downloader\utils;.\utils" "E:\python_test_project\main.py"
5.踩坑经验
1.被卫士类软件拦截
尽量退出360等软件,不然涉及到dll操作可能会被拦截导致打包失败,甚至可能直接当成病毒处理了。
2.打包处理的程序很大
如果打包出来的程序很大,考虑一下是不是自己的Python环境安装了太多的库,pyinstaller可能会把用不到的库也打包进去,解决方法是新建一个干净的虚拟环境,只安装用得到的库就行。
3.路径错误
如果你的项目并不只有一个.py文件,即存在自定义模块,那就不要使用-F参数打包成单一的可执行程序,否则可能会因为路径问题导致不能正常工作。另外工作路径尽量不要出现中文。