项目环境：

我的环境：Window10，Python3.7，Anaconda3-2.4.0，Pycharm2023.1.3

---

问题描述①：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

1

socket.timeout: The read operation timed out

2

raise ReadTimeoutError(self._pool, None, 'Read timed out.')
pip._vendor.requests.packages.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.

①原因分析：

网络问题：连接到Python包索引（PyPI）的网络连接存在问题，如连接超时或连接被拒绝

①解决：

1.python -m pip --default-timeout=200 install PyMuPDF，通过加长超时时间，超时时间 --default-timeout 设置为 200s

2.你可以加入镜像源指定安装源，例如我这个PyMuPDF安装

代码：

②
pip install  PyMuPDF -i https://pypi.tuna.tsinghua.edu.cn/simple

①效果展示：

加入清华镜像源之后很好的安装了

---

问题描述②：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

WARNING: You are using pip version 22.0.3; however, version 22.0.4 is available.
You should consider upgrading via the '/usr/local/bin/python -m pip install --upgrade pip' command.

②原因分析：

pip版本过旧：使用的pip版本过旧，不支持某些新特性或存在已知的bug。

②解决：

按他说的更新pip：python -m pip install --upgrade pip

---

问题描述③：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

1

Import Error:cannot import name 'tf_utils'

2

ERROR: Could not find a version that satisfies the requirement pandas==6.5 (from versions: ...)
ERROR: No matching distribution found for PyMuPDF==3.9

3

ERROR: PyMuPDF-modules 0.2.7 has requirement PyMuPDF<0.5.0,>=0.4.6, but you'll have PyMuPDF 0.1.9 which is incompatible.

4

ERROR: PyMuPDF 3.3.6 requires pytest<5.13; python_version >= "3", which is not installed.

③原因分析：

依赖问题：所安装的库有特定的依赖项，而这些依赖项未能正确安装或不兼容。

③解决：

1.在安装TensorFlow(1.5.0)和Keras(2.3.1)的时候发生的报错，原因是Keras版本过高，降低Keras的版本为2.1.3

把PyMuPDF的版本都告诉你，然后说没有PyMuPDF==3.9的版本，原因是PyMuPDF版本过高，根据他提供的版本来安装

在安装某些库时，会出现类似上方报错，原版本不符合要求，更新PyMuPDF库即可

提示pytest库版本需低于5.13，且python版本需为python3，则需要将pytest库降低版本至5.12即可。命令行参考：pip install pytest==5.12.0

---

问题描述④：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

1

④原因分析：

Python环境未正确安装：Python环境未正确配置或未添加到系统环境变量中。

④解决：

1.可以配置下 Python 环境变量，或者直接把 Python 重新安装到 C 盘

2.自动升级；手动升级（可直接使用全局 pip 来安装依赖包）

• 对pip安装升级下：python -m ensurepip --upgrade
• 手动升级：首先打开 https://bootstrap.pypa.io/get-pip.py
  然后右击页面–另存为–保存到任何地方
  最后在 get-pip.py 文件所在目录的命令行执行 python get-pip.py

---

问题描述⑤：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

Could not install packages due to an EnvironmentError: [WinError 5] 拒绝访问。: 'C:\\Users\\SueMagic\\AppData\\Local\\Temp\\pip-uninstall-olx6o3zb\\pip.exe'

⑤原因分析：

权限问题：在没有管理员权限的情况下尝试安装库，可能会导致权限错误。

⑤解决：

修改pip更新命令为：pip install -U --user pip

使用管理员运行cmd

---

问题描述⑥：

pip install 命令安装不了需要的安装的Python库，以PyMuPDF为例

WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1123)'))': /simple/pip/

Could not fetch URL https://pypi.org/simple/pip/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='PyPI · The Python Package Index', port=443): Max retries exceeded with url: /simple/pip/ (Caused by SSLError(SSLError(1, '[SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1123)'))) - skipping

⑥原因分析：

SSL证书问题：在使用HTTPS连接下载包时，可能会遇到SSL证书验证问题。

⑥解决：

在C:/Users/XXX/路径下，新建pip文件夹，并新建pip.ini文件，文件内容如下：

[global]
index-url=https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host=pypi.tuna.tsinghua.edu.cn

并在环境变量中新增“C:/Users/XXX/pip”即可。

---

超强解决：

手动下载：如果pip安装始终失败，可以尝试从PyPI官网手动下载.whl文件，并使用pip进行本地安装。

①whl文件安装

从pypi官网上下载指定的.whl文件---->>>搜索PyMuPDF—>>>在Download files版块可以看到下列文件：

—>>>点击链接就能进入下载—>>>下载完成后切换到指定文件夹，cmd输入pip install XXX

pip install PyMuPDF-1.24.2-cp312-none-win_amd64.whl

②安装包安装

下载XXX.tar.gz的文件—>>>解压tar.gz—>>>进入setup.py的目录—>>>cmd输入python setup.py install

③Github安装

①在线安装Github的PyMuPDF—>>>pip install git+https://github.com/pymupdf/PyMuPDF.git
②离线安装Github的PyMuPDF—>>>找到下载好的Github上的python包—>>>同安装包安装

---

希望本文对你安装Python的XXX库提供了帮助。
SueMagic wish you a happy coding~
有疑问可联系我。

---

友情链接参考：

安装PyMuPDF库的方法最终解答！_Python库

国内开源镜像站点