python中pyinstaller的安装教程及常见问题详解

• 本文收录于《Python开发》专栏，此专栏聚焦于Python开发中的编程技巧和总结，将持续更新，欢迎大家订阅！
• 个人主页：有梦想的程序星空
• 个人介绍：小编是人工智能领域硕士，全栈工程师，深耕Flask后端开发、数据挖掘、NLP、Android开发、自动化等领域，有较丰富的软件系统、人工智能算法服务的研究和开发经验。
• 如果文章对你有帮助，欢迎关注、点赞、收藏、订阅。

1、安装：

建议使用pip命令进行安装，方便快捷，如下：

pip install pyinstaller

2、使用方式：

首先，在需要打包的xxx.py文件所在目录下打开cmd窗口，

然后，使用如下命令进行打包。

pyinstaller -F xxx.py

3、输入参数的含义：

-h，--help 查看该模块的帮助信息

-F，-onefile 产生单个可执行文件

-D，--onedir 产生一个目录（包含多个文件）作为可执行程序

-w，--windowed，--noconsolc 指定程序运行时不显示命令行窗口（仅对 Windows 有效）

-c，--nowindowed，--console 指定使用命令行窗口运行程序（仅对 Windows 有效）

-n NAME，--name=NAME 指定项目（产生的 spec）名字。如果省略该选项，那么第一个脚本的主文件名将作为 spec 的名字

4、容易出现的问题：

（1）问题描述：

有时候，我们执行pyinstaller -F xxx.py文件时，会遇到如下的错误提示：

RecursionError: maximum recursion depth exceeded

说明某个库文件递归调用次数过多，超过了Python的最大栈高度的限制。

解决方案如下：

在生成的xxx.spec文件头部增加如下两行：

import sys
sys.setrecursionlimit(5000)

然后执行

pyinstaller xxx.spec

即可打包成功。

（2）问题描述

pyinstaller 打包tensorflow时出错，会遇到如下的报错信息：

如：ModuleNotFoundError: No module named 'tensorflow_core.python"

该类型错误还有ImportError: cannot import name 'pywrap_tensorflow' 等

解决方案如下：

运行报错是由于pyinstaller无法导入tensorflow_core。

问题解决方式为：在所运行的python文件（例如：app.py中使用from tensorflow import *）路径的同目录下创建一个名为hooks的文件夹，文件夹内创建python程序文件hook-tensorflow.py。

目录结构：

--app.py

--hooks

  --hook-tensorflow.py

hook-tensorflow.py中的内容如下：

from PyInstaller.utils.hooks import collect_all

def hook(hook_api):

    packages = [

        'tensorflow',

        'tensorflow_core',

        'astor'

    ]

    for package in packages:

        datas, binaries, hiddenimports = collect_all(package)

        hook_api.add_datas(datas)

        hook_api.add_binaries(binaries)

        hook_api.add_imports(*hiddenimports)

运行pyinstaller时添加参数：

--additional-hooks-dir=hooks

最终运行的命令为：

pyinstaller --additional-hooks-dir=hooks app.py

（3）问题描述

使用pyinstaller打包执行时报错：FileNotFoundError:No such file or directory。

解决办法如下：

最简单的就是将跟.xx（找不到的文件）相关的整个文件放到dist目录下，执行就OK了。

关注微信公众号【有梦想的程序星空】，了解软件系统和人工智能算法领域的前沿知识，让我们一起学习、一起进步吧！