【Python】使用pyinstaller打包Python程序为EXE可执行程序

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参数打包成单一的可执行程序，否则可能会因为路径问题导致不能正常工作。另外工作路径尽量不要出现中文。