快捷導(dǎo)航

PyInstaller與pathlib包不兼容的解決方法

更新時間：2024年12月03日 09:53:34 作者：winfredzhang

當我們在使用PyInstaller打包Python程序時,可能會遇到PyInstaller與pathlib包不兼容的問題,這個錯誤的原因是,pathlib這個包在?Python3.4版本之后已經(jīng)成為了Python標準庫的一部分,所以不需要再單獨安裝,所以本文給大家介紹了PyInstaller與pathlib包不兼容的解決方法

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 版本之后已經(jīng)成為了 Python 標準庫的一部分，所以不需要再單獨安裝。而如果在安裝了該包的環(huán)境中使用 PyInstaller，它會和 Python 標準庫中的 pathlib 包發(fā)生沖突，導(dǎo)致 PyInstaller 無法正確工作。

解決方法

1. 卸載 pathlib 包

由于在 Python 3.10 中，pathlib 已經(jīng)是標準庫的一部分，我們不再需要額外安裝它。因此，首先需要卸載已經(jīng)安裝的 pathlib 包。

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

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

執(zhí)行該命令后，pathlib 包將被成功卸載。

2. 再次運行 PyInstaller

卸載 pathlib 后，可以重新嘗試使用 PyInstaller 來打包你的程序。如果沒有其他問題，打包應(yīng)該會順利完成。

為什么會出現(xiàn)這個問題？

pathlib 是一個用于操作文件路徑的模塊，最早作為第三方庫發(fā)布，后來在 Python 3.4 中被正式納入標準庫中。對于較新的 Python 版本（如 3.4 及以上版本），不需要再額外安裝 pathlib。然而，在一些舊的項目中，可能還會誤安裝這個庫，導(dǎo)致出現(xiàn)兼容性問題。

在使用 PyInstaller 等工具進行打包時，它會掃描項目中所有的依賴庫并將其包括在內(nèi)。如果你在 Python 3.10 中仍然安裝了 pathlib，PyInstaller 會將其錯誤地認為是一個獨立的庫，并嘗試將它包含進打包文件中，從而引發(fā)錯誤。