pyinstaller打包时出现RecursionError: maximum recursion depth exceeded的报错

在 Python 开发领域，编写好的代码通常需要在不同的环境中运行，而目标环境可能并不一定安装了 Python 解释器及相关依赖库。PyInstaller 应运而生，它是一个功能强大的第三方库，能够将 Python 应用程序及其依赖项打包成独立的可执行文件，使得 Python 应用可以在没有 Python 开发环境的机器上便捷地运行，极大地拓展了 Python 应用的部署范围和使用场景。

问题：

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

RecursionError: maximum recursion depth exceeded

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

解决方案如下：

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

import sys
sys.setrecursionlimit(5000)

然后执行

pyinstaller xxx.spec

即可打包成功。

PyInstaller 概述

PyInstaller 的主要作用是将 Python 脚本以及其所需的所有依赖模块（包括标准库模块、第三方库模块等）、数据文件（如配置文件、图片、文本文件等）整合到一个独立的文件夹或单个可执行文件中。这个打包后的可执行文件在运行时，会在内部创建一个临时的运行环境，类似于一个小型的 Python 解释器环境，从而能够在不依赖外部 Python 安装的情况下执行应用程序。
例如，你开发了一个基于 PyQt 的图形用户界面应用程序，使用了多个第三方库如 numpy、pandas 等。通过 PyInstaller，你可以轻松地将这个应用程序打包成一个可执行文件，在其他 Windows、Linux 或 Mac 系统上直接运行，而无需在这些系统上预先安装 Python 以及相关的库，方便用户使用，也提高了应用程序的分发效率。

PyInstaller 的优势与局限性

（一）优势
跨平台支持：PyInstaller 可以在 Windows、Linux 和 Mac 等主流操作系统上使用，能够方便地将 Python 应用程序打包成适用于不同平台的可执行文件，大大提高了 Python 应用的跨平台部署能力。
简单易用：其基本的打包命令非常简洁，通过一些常用的命令行参数就可以满足大多数打包需求。即使对于不熟悉打包工具的 Python 开发者来说，也能够快速上手并完成应用程序的打包工作。
依赖项自动处理：PyInstaller 能够自动检测 Python 应用程序所依赖的库和模块，并将它们一并打包到可执行文件中，无需开发者手动去收集和整理依赖项，减少了打包过程中的错误和繁琐性。

总结与应用场景

PyInstaller 是 Python 应用程序打包领域的一个重要工具，它为 Python 开发者提供了一种便捷的方式将应用程序及其依赖项打包成独立可执行文件，使得 Python 应用能够更广泛地应用于不同的环境和用户群体。
其主要应用场景包括：
桌面应用程序分发：将基于 Python 的图形用户界面应用程序打包成可执行文件，方便用户在没有 Python 环境的电脑上安装和使用，如数据可视化工具、办公自动化软件等。
命令行工具部署：将 Python 编写的命令行工具打包成独立的可执行文件，使其可以在各种服务器环境或用户终端上直接运行，无需担心 Python 环境的配置问题，如数据处理脚本、系统管理工具等。
教学与演示：在教学过程中或软件演示场景下，将 Python 示例程序或小型应用打包成可执行文件，方便学生或观众在不同的设备上直接运行和体验，而无需安装复杂的 Python 开发环境。

尽管 PyInstaller 存在一些局限性，但在大多数情况下，它仍然是 Python 开发者进行应用程序打包和分发的首选工具之一。通过合理地利用其功能和特点，并结合其他技术手段来解决可能出现的问题，可以有效地提高 Python 应用的部署效率和用户体验。