最近利用tkinter+python+pyinstaller实现了小工具的项目，在此记录下pyinstaller相关参数以及爬过的坑。
一、pyinstaller相关参数
-F, –onefile **打包一个单个文件，**如果你的代码都写在一个.py文件的话，可以用这个，如果是多个.py文件就别用
-D, –onedir 打包多个文件，在dist中生成很多依赖文件，适合以框架形式编写工具代码，我个人比较推荐这样，代码易于维护
-K, –tk 在部署时包含 TCL/TK
-a, –ascii 不包含编码.在支持Unicode的python版本上默认包含所有的编码.
-d, –debug 产生debug版本的可执行文件
-w,–windowed,–noconsole 使用Windows子系统执行.当程序启动的时候不会打开命令行(只对Windows有效)
-c,–nowindowed,–console
使用控制台子系统执行(默认)(只对Windows有效)
pyinstaller -c xxxx.py
pyinstaller xxxx.py --console
-s,–strip 可执行文件和共享库将run through strip.注意Cygwin的strip往往使普通的win32 Dll无法使用.
-X, –upx 如果有UPX安装(执行Configure.py时检测),会压缩执行文件(Windows系统中的DLL也会)(参见note)
-o DIR, –out=DIR 指定spec文件的生成目录,如果没有指定,而且当前目录是PyInstaller的根目录,会自动创建一个用于输出(spec和生成的可执行文件)的目录.如果没有指定,而当前目录不是PyInstaller的根目录,则会输出到当前的目录下.
-p DIR, –path=DIR 设置导入路径(和使用PYTHONPATH效果相似).可以用路径分割符(Windows使用分号,Linux使用冒号)分割,指定多个目录.也可以使用多个-p参数来设置多个导入路径，让pyinstaller自己去找程序需要的资源
–icon=<FILE.ICO>
将file.ico添加为可执行文件的资源(只对Windows系统有效)，改变程序的图标 pyinstaller -i ico路径 xxxxx.py
–icon=<FILE.EXE,N> 将file.exe的第n个图标添加为可执行文件的资源(只对Windows系统有效)
-v FILE, –version=FILE 将verfile作为可执行文件的版本资源(只对Windows系统有效)
-n NAME, –name=NAME 可选的项目(产生的spec的)名字.如果省略,第一个脚本的主文件名将作为spec的名字
二、pyinstaller爬坑总结
在这里提醒大家，在代码里面尽量不要用import，能from…import…就尽量用这个，因为如果是import的话，在打包的时候，会将整个包都打包到exe里面，没有意义的增大了工具的大小！
说明
以下介绍假设用户脚本为main.py，生成结果为main.exe。
有些参数实在很少用到，具体请参阅原文。
原文(英文): https://pyinstaller.readthedocs.io/en/v3.3.1/usage.html
1
2
3
4
通用参数
参数名 描述 说明
-h 显示帮助 无
-v 显示版本号 无
–distpath 生成文件放在哪里 默认：当前目录的dist文件夹内
–workpath 生成过程中的中间文件放在哪里 默认：当前目录的build文件夹内
-y 如果dist文件夹内已经存在生成文件，则不询问用户，直接覆盖 默认：询问是否覆盖
–upx-dir UPX_DIR 指定upx工具的目录 默认：execution path
-a 不包含unicode支持 默认：尽可能支持unicode
–clean 在本次编译开始时，清空上一次编译生成的各种文件 默认：不清除
–log-level LEVEL 控制编译时pyi打印的信息 一共有5个等级，由低到高分别为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 请参考原文
1、Pyinstaller打包出现UnicodeDecodeError: ‘utf-8’ codec can’t decode byte 0xce in position 解决方案：
在你打包的命令行中先输入chcp 65001 然后再输入打包命令。
pyinstaller -F xxx.py
[Keras] ValueError: Tensor Tensor is not an element of this graph.
（1）和上面博客写的一样，这是刚开始最简单的解决办法，load_model()只能加载一次，如果再加载一次，肯定报上面的错
（2）tensorflow的操作都是默认加载在一个默认的Graph中，所以如果为了避免出错，自己就要创建Graph以及Session,
model = load_model (‘XX.h5’)
在用pyinstaller打包（-F 选项），如果用到的第三方库含有data文件，而pyinstaller又没有自带该第三方库文件的hook的时候，执行打包后的exe一般会报以下错误
FileNotFoundError: [Errno 2] No such file or directory: ‘C:\Users\ADMINI~1\AppData\Local\Temp\1\_MEI54762\jieba\dict.txt’
[20784] Failed to execute script bat_server
上面就是没把python库jieba的dict.txt打包进来，导致了错误。
那么，解决问题也很简单，自己写个hook，然后放进pyinstaller的hooks里面即可。
hook文件的命名规范为: hook-【库名】.py，以结巴分词为例，即为hook-jieba.py，然后简单敲入以下两行：
from PyInstaller.utils.hooks import collect_data_files
datas = collect_data_files(“jieba”)
接下来，找到pyinstaller的hooks文件夹，大概位于：
python根目录\Lib\site-packages\PyInstaller\hooks下，然后把hook-jieba.py丢进去，如下图所示:
从此网站转：https://blog.csdn.net/lucyTheSlayer/article/details/92795220
最后，回到项目根目录，用pyinstaller打包即可。（注意需要把build目录删了，使pyinstaller从头开始打包）
当看到pyinstaller的日志里使用了我们自定义的hook后，就万事大吉了。
ok
PS：打包tushare的时候也有类似问题，下次可以直接用此法解决。