基于PyInstaller各参数的含义说明

说明

以下介绍假设用户脚本为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

为程序添加图标

以上为个人经验，希望能给大家一个参考，也希望大家多多支持。如有错误或未考虑完全的地方，望不吝赐教。