PyInstaller与pathlib包不兼容的解决方法

在使用 PyInstaller 打包 Python 程序时，可能会遇到类似如下的错误提示：

The 'pathlib' package is an obsolete backport of a standard library package and is incompatible with PyInstaller. Please remove this package (located in C:\Users\users\AppData\Local\Programs\Python\Python310\lib\site-packages) using
    "C:\Users\users\AppData\Local\Programs\Python\Python310\python.exe" -m pip uninstall pathlib
then try again.

这个错误的原因是，pathlib 这个包在 Python 3.4 版本之后已经成为了 Python 标准库的一部分，所以不需要再单独安装。而如果在安装了该包的环境中使用 PyInstaller，它会和 Python 标准库中的 pathlib 包发生冲突，导致 PyInstaller 无法正确工作。

解决方法

1. 卸载 pathlib 包

由于在 Python 3.10 中，pathlib 已经是标准库的一部分，我们不再需要额外安装它。因此，首先需要卸载已经安装的 pathlib 包。

在命令行中运行以下命令：

C:\Users\user\AppData\Local\Programs\Python\Python310\python.exe -m pip uninstall pathlib

执行该命令后，pathlib 包将被成功卸载。

2. 再次运行 PyInstaller

卸载 pathlib 后，可以重新尝试使用 PyInstaller 来打包你的程序。如果没有其他问题，打包应该会顺利完成。

为什么会出现这个问题？

pathlib 是一个用于操作文件路径的模块，最早作为第三方库发布，后来在 Python 3.4 中被正式纳入标准库中。对于较新的 Python 版本（如 3.4 及以上版本），不需要再额外安装 pathlib。然而，在一些旧的项目中，可能还会误安装这个库，导致出现兼容性问题。

在使用 PyInstaller 等工具进行打包时，它会扫描项目中所有的依赖库并将其包括在内。如果你在 Python 3.10 中仍然安装了 pathlib，PyInstaller 会将其错误地认为是一个独立的库，并尝试将它包含进打包文件中，从而引发错误。

总结

为了避免 PyInstaller 和 pathlib 包的兼容性问题，最简单的解决办法就是卸载不必要的 pathlib 包。只需在命令行中运行卸载命令，然后重新打包即可。

到此这篇关于PyInstaller与pathlib包不兼容的解决方法的文章就介绍到这了,更多相关PyInstaller与pathlib包不兼容内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！