说明
以下介绍假设用户脚本为main.py,生成结果为main.exe。
有些参数实在很少用到,只列出简单介绍,具体请参阅原文。
通用参数
参数名 |
描述 |
说明 |
-h
显示帮助
无
-v
显示版本号
无
–distpath
生成文件放在哪里
默认:当前目录的dist文件夹内
–workpath
生成过程中的中间文件放在哪里
默认:当前目录的build文件夹内
-y
如果dist文件夹内已经存在生成文件,则不询问用户,直接覆盖
默认:询问是否覆盖
–upx-dir UPX_DIR
指定upx工具的目录
默认:execution path
-a
不包含unicode支持
默认:尽可能支持unicode
–clean
在本次编译开始时,清空上一次编译生成的各种文件
默认:不清除
–log-level LEVEL
控制编译时pyi打印的信息
一共有6个等级,由低到高分别为TRACE DEBUG INFO(默认) WARN ERROR CRITICAL。也就是默认清空下,不打印TRACE和DEBUG信息
与生成结果有关的参数
参数名 |
描述 |
说明 |
-D
生成one-folder的程序(默认)
生成结果是一个目录,各种第三方依赖、资源和exe同时存储在该目录
-F
生成one-file的程序
生成结果是一个exe文件,所有的第三方依赖、资源和代码均被打包进该exe内
–specpath
指定.spec文件的存储路径
默认:当前目录
-n
生成的.exe文件和.spec的文件名
默认:用户脚本的名称,即main.py和main.spec
指定打包哪些资源、代码
参数名 |
描述 |
说明 |
–add-data
打包额外资源
用法:pyinstaller main.py --add-data=src;dest。windows以;分割,linux以:分割
–add-binary
打包额外的代码
用法:同–add-data。与–add-data不同的是,用binary添加的文件,pyi会分析它引用的文件并把它们一同添加进来
-p
指定额外的import路径,类似于使用PYTHONPATH
参见PYTHONPATH
–hidden-import
打包额外py库
pyi在分析过程中,有些import没有正确分析出来,运行时会报import error,这时可以使用该参数
–additional-hooks-dir
指定用户的hook目录
hook用法参见其他,系统hook在PyInstaller\hooks目录下
–runtime-hook
指定用户runtime-hook
如果设置了此参数,则runtime-hook会在运行main.py之前被运行
–exclude-module
需要排除的module
pyi会分析出很多相互关联的库,但是某些库对用户来说是没用的,可以用这个参数排除这些库,有助于减少生成文件的大小
–key
pyi会存储字节码,指定加密字节码的key
16位的字符串
生成参数
参数名 |
描述 |
说明 |
-d
执行生成的main.exe时,会输出pyi的一些log,有助于查错
默认:不输出pyi的log
-s
优化符号表
原文明确表示不建议在windows上使用
–noupx
强制不使用upx
默认:尽可能使用。
其他
参数名 |
描述 |
说明 |
–runtime-tmpdir
指定运行时的临时目录
默认:使用系统临时目录
Windows和Mac特有的参数
参数名 |
描述 |
说明 |
-c
显示命令行窗口
与-w相反,默认含有此参数
-w
不显示命令行窗口
编写GUI程序时使用此参数有用。
-i
为main.exe指定图标
pyinstaller -i beauty.ico main.py
Windows特有的参数
参数名 |
描述 |
说明 |
–version-file
添加版本信息文件
pyinstaller --version-file ver.txt
-m, --manifest
添加manifest文件
pyinstaller -m main.manifest
-r RESOURCE
请参考原文
–uac-admin
请参考原文
–uac-uiaccess
请参考原文
补充:pyinstaller打包exe常用参数
pyinstaller 是python的一个包,可以把python程序打包成exe文件,这样其他未安装python的PC也可以执行python写的程序
安装
常用参数
-D example.py
生成一个文件夹,里面有exe文件及其动态库
-F example.y
只生成exe文件
-w
运行exe时不显示控制台
-c
运行exe时显示控制台
-i example.ico
为程序添加图标
以上为个人经验,希望能给大家一个参考,也希望大家多多支持。如有错误或未考虑完全的地方,望不吝赐教。