原文：https://lwebapp.com/zh/post/pip-install-error-guide
问题
我们在使用 Python 开发的时候，通常会用到一些好用的第三方库，推荐用 pip 来安装，比如安装 pandas
python -m pip install pandas
一般情况下都没有什么问题，但是有些小伙伴会碰到 pip 安装第三方库报错、pip install 卡住不动等安装失败的情况。
比如以下是 pip 安装第三方库报错的代码
Retrying (Retry(total=1, connect=None, read=None, redirect=None, status=None))...
小编在这里就总结下 Python 安装第三方库失败的解决方案有哪些。
解决
方案一
Python 环境因素报错，检查你的电脑下的 Python 和 pip 是否是正常安装好的
# 打印当前Python版本
python --version
运行以上命令如果正常打印出了 Python 版本信息，表明是正常的。报错的话，可能是在 Windows 下安装 Python 的时候环境变量没有配置，可以配置下 Python 环境变量，或者直接把 Python 重新安装到 C 盘，这样就不会有环境变量的问题。
# 打印pip版本
python -m pip --version
运行以上命令如果正常打印出了 pip 版本信息，表明是正常的。报错的话，可以用这个命令安装升级下
python -m ensurepip --upgrade
如果还不能运行 pip，也可以手动安装 pip
- 打开 https://bootstrap.pypa.io/get-pip.py
- 右击页面–另存为–保存到任何地方
- 在 get-pip.py 文件所在目录的命令行执行
python get-pip.py就能成功安装 pip
手动安装 pip 还有个好处，可以直接使用全局 pip 来安装依赖包，比如
pip install pandas
方案二
pip 虽然正常安装了，但有时候会提示你的 pip 版本过低
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
python -m pip install --upgrade pip
方案三
第三方包名称或者版本号输入错误，比如我在命令行终端安装一个叫 padas 的包
python -m pip install padas
会出现以下报错
ERROR: Could not find a version that satisfies the requirement padas (from versions: none)
ERROR: No matching distribution found for padas
这个错误提示我输入了 padas，提示找不到这个包和它的版本号。这时需要检查包名称是否输入正确，正确的应该是 pandas。（当然文章发布之后，可能有开发者朋友发布了这个包，这里仅仅作为演示）
还有版本号也可能不存在的问题，比如我安装一个高版本的 pandas
python -m pip install pandas==6.5
会出现以下报错
ERROR: Could not find a version that satisfies the requirement pandas==6.5 (from versions: 0.1, 0.2, 0.3.0, 0.4.0, 0.4.1, 0.4.2, 0.4.3, 0.5.0, 0.6.0, 0.6.1, 0.7.0, 0.7.1, 0.7.2, 0.7.3, 0.8.0, 0.8.1, 0.9.0, 0.9.1, 0.10.0, 0.10.1, 0.11.0, 0.12.0, 0.13.0, 0.13.1, 0.14.0, 0.14.1, 0.15.0, 0.15.1, 0.15.2, 0.16.0, 0.16.1, 0.16.2, 0.17.0, 0.17.1, 0.18.0, 0.18.1, 0.19.0, 0.19.1, 0.19.2, 0.20.0, 0.20.1, 0.20.2, 0.20.3, 0.21.0, 0.21.1, 0.22.0, 0.23.0, 0.23.1, 0.23.2, 0.23.3, 0.23.4, 0.24.0, 0.24.1, 0.24.2, 0.25.0, 0.25.1, 0.25.2, 0.25.3, 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.0.4, 1.0.5, 1.1.0, 1.1.1, 1.1.2, 1.1.3, 1.1.4, 1.1.5, 1.2.0, 1.2.1, 1.2.2, 1.2.3, 1.2.4, 1.2.5, 1.3.0, 1.3.1, 1.3.2, 1.3.3, 1.3.4, 1.3.5, 1.4.0rc0, 1.4.0, 1.4.1)
ERROR: No matching distribution found for pandas==6.5
很明显找不到这个版本号，而且把所有可以安装的版本号都告诉你了，我们只需要选择一个我们需要的版本号就可以，或者不指定版本号默认安装最新版本。
方案四
每个地方的网络质量、通信速度都不一样，pip 安装依赖包也会遇到网络超时问题，比如以下报错
raise ReadTimeoutError(self._pool, None, 'Read timed out.')
pip._vendor.requests.packages.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='pypi.org', port=443): Read timed out.
表明是网络超时了，提示连接到 pypi.org 出了问题，这个就是托管 python 依赖包的网站，所有的 pip 包都发布在上面。
我们可以设置加长超时时间，因为大多数地方的网络并不是完全连接不上，只是速度有点感人。这里将默认的超时时间 --default-timeout 设置为 200s
python -m pip --default-timeout=200 install pandas
设置多一点的超时时间，去喝杯茶慢慢等一等，就可能下载好了。
方案五
如果喝完茶后还没下载好，接着考虑换镜像源了，比如我们切换到清华大学的镜像源
# --index-url可以简写为-i
python -m pip install --index-url https://pypi.tuna.tsinghua.edu.cn/simple/ pandas
除了官方源和清华镜像源
- 清华：
https://pypi.tuna.tsinghua.edu.cn/simple/ - 官方：
https://pypi.org/
还有些别的镜像源可以尝试
- 阿里云：
https://mirrors.aliyun.com/pypi/simple/ - 豆瓣：
https://pypi.douban.com/simple/ - 北京外国语大学
https://mirrors.bfsu.edu.cn/pypi/web/simple/
方案六
除了切换镜像源之外，pip 官方还提供了多种安装依赖包的途径
- 将依赖包提前下载好，然后从本地路径直接安装
比如我们可以从 pip 官网下载 pandas 的发行包文件，然后在本地依赖包所在目录执行安装命令。
从源码包安装
python -m pip install pandas-1.4.1.tar.gz
或者从构建包安装
# 仅用于 Windows 平台的构建包
python -m pip install pandas-1.4.1-cp310-cp310-win_amd64.whl
所有的 pandas 分发包列表：pandas download files
- 从任何的 VCS（version control systems 版本控制系统）安装，使用如下格式
python -m pip install -e "vcs+protocol://repo_url/#egg=pkg&subdirectory=pkg_dir"
- vcs：版本控制系统名称
- protocol：协议
- repo_url：仓库地址
- egg：包名称
- subdirectory：如果包不在项目根目录，指定子目录名称
比如直接从 github 安装 pandas 库
python -m pip install git+https://github.com/pandas-dev/pandas.git#egg=pandas
这种方式会从 github 上拉取最新代码做本地构建，需要的时间比较长，一般也是开发版本。
官方支持非常多的版本控制系统和协议，详细查看 VCS 支持
- 从 github 安装还支持手动本地安装，将依赖包的 github 仓库直接 clone 下来，在项目目录中执行
python setup.py install
这样就直接安装了这个项目所构建的库，本质上和用 github 远程方式差不多，都需要做本地编译，通常用作本地开发阶段使用，或者想尝试下项目最新特性。
不过如果你通过 pip install 的方式就有网络问题，这种通过 github 安装的方式通常也有一定网络问题。
方案七
小编尝试了上面几种方案，都无法很完美的满足我的需求，
- 虽然设置了很长的超时时间，但是有时候网络就是很慢，超时再长也很浪费时间
- 镜像相比较官方站有一点延后的同步时间，官方
pypi.org的依赖包最为稳定，同样的问题在前端开发的 npm 包管理中也很常见，镜像源有时候会出现不可预测的错误，而往往切换到官方源就修复了（参照 npm install 报错卡住） - 直接下载源码包构建的话，因为很多 Python 库都是外国人写的，网站不在本国家，访问其他国家网站的时候下载速度很慢，从 github 下载也是一样的情况（参照 github clone 很慢）
我们可以考虑一些更科学的上网方式，来加快对官方网站的访问速度。加速之后直接使用pip install安装任何第三方库，基本上几秒钟就可以完成，无需设置超时时间，不需要切换镜像源，无需担心安装包版本延迟问题，想从 pip 官网下载源码包或者使用 github 远程安装 Python 第三方库都非常快。
除此之外，还有以下好处
- 你在访问一些 Python 第三方库的文档的时候，也可以加快访问速度，比如 pandas 官网
https://pandas.pydata.org/ - 上 github 学习开源项目源码，使用
git clone来拉取 github 开源项目的时候，速度提升明显 - 使用谷歌搜索出的技术文档往往更精准，排在搜索结果前面的都是 stackoverflow 上的高赞回答，非常有用
- 访问其他一些优秀的技术网站
更科学的方式推荐：官方网站 ➜
不太明白的请参考这位小编的 踩坑经验 ➜
