快捷導(dǎo)航

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

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

當(dāng)我們?cè)谑褂肞yInstaller打包Python程序時(shí),可能會(huì)遇到PyInstaller與pathlib包不兼容的問(wèn)題,這個(gè)錯(cuò)誤的原因是,pathlib這個(gè)包在?Python3.4版本之后已經(jīng)成為了Python標(biāo)準(zhǔn)庫(kù)的一部分,所以不需要再單獨(dú)安裝,所以本文給大家介紹了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.

這個(gè)錯(cuò)誤的原因是，pathlib 這個(gè)包在 Python 3.4 版本之后已經(jīng)成為了 Python 標(biāo)準(zhǔn)庫(kù)的一部分，所以不需要再單獨(dú)安裝。而如果在安裝了該包的環(huán)境中使用 PyInstaller，它會(huì)和 Python 標(biāo)準(zhǔn)庫(kù)中的 pathlib 包發(fā)生沖突，導(dǎo)致 PyInstaller 無(wú)法正確工作。

解決方法

1. 卸載 pathlib 包

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

在命令行中運(yùn)行以下命令：

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

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

2. 再次運(yùn)行 PyInstaller

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

為什么會(huì)出現(xiàn)這個(gè)問(wèn)題？

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

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