彻底解决pyinstaller打包难题——告别“成报错：功解决The ‘pathlib‘ package is an obsolete backport of a standard library package”的烦恼

成功解决 PyInstaller 打包 Python 项目中 “pathlib” 模块冲突

在使用 PyInstaller 打包 Python 项目时，您可能遇到令人头疼的错误提示："成报错：功解决The ‘pathlib‘ package is an obsolete backport of a standard library package"。别担心，这个问题很容易解决，遵循本指南，我们将引导您一步步解决它。

“pathlib” 模块是什么？

“pathlib” 是 Python 标准库中的一个模块，它提供了操作路径的便利方法。但是，PyInstaller 默认将其作为一个第三方模块进行打包，这会导致冲突。

解决冲突

解决此错误的关键在于调整 PyInstaller 的配置文件，即 pyinstaller.conf。

1. 移出排除列表

首先，我们需要将 “pathlib” 模块从 PyInstaller 的排除列表中移除。打开 pyinstaller.conf 文件（通常位于 ~/.pyinstaller 目录），找到 [Exclude] 部分，然后将以下行删除：

pathlib

2. 添加到包含列表

接下来，我们将 “pathlib” 模块添加到 PyInstaller 的包含列表中。找到 [Include] 部分，并添加以下行：

pathlib

3. 重新打包

保存 pyinstaller.conf 文件并关闭它。现在，您可以重新运行 PyInstaller 进行打包。在命令行中，导航到您要打包的 Python 项目目录，并运行以下命令：

pyinstaller --onefile --noconsole script.py

其中 script.py 是您要打包的 Python 脚本文件。

代码示例：

import pathlib

# 创建一个路径对象
path = pathlib.Path("/home/user/my_project")

# 打印路径
print(path)

常见问题解答

1. 找不到 pyinstaller.conf 文件怎么办？

如果您找不到 pyinstaller.conf 文件，请尝试在 ~/.config/pyinstaller 目录中查找它。

2. 我已经按照步骤操作，但仍然收到错误。

确保您正确修改了 pyinstaller.conf 文件，并保存了更改。此外，请确保您使用的是 PyInstaller 的最新版本。

3. 为什么 PyInstaller 会将 “pathlib” 模块作为第三方模块进行打包？

PyInstaller 的目的是将您的 Python 项目打包为独立的可执行文件。由于 “pathlib” 模块已经包含在 Python 标准库中，因此 PyInstaller 默认将其排除，以避免与系统安装的版本冲突。

4. 修改 pyinstaller.conf 文件有风险吗？

只要您按照本指南中的步骤操作，修改 pyinstaller.conf 文件应该是安全的。但是，始终建议在进行任何更改之前备份原始文件。

5. 是否有其他方法可以解决此错误？

除了修改 pyinstaller.conf 文件之外，还有一种方法是使用 --hidden-import 选项。但是，这种方法不建议使用，因为它可能导致其他问题。

结论

通过遵循本指南中的步骤，您应该能够成功解决 “pathlib” 模块冲突问题，并顺利打包您的 Python 项目。如果您还有任何问题，请随时在下方评论区留言。