Python3.9.6环境安装Django出现No matching distribution错误如何解决

• 报错的根因是pip连接官方PyPI源时出现SSL/TLS证书校验失败，无法正常拉取Django的版本列表，最终返回ERROR: No matching distribution found for django错误。
• 常见触发场景包括：本地网络开启了代理/防火墙拦截了PyPI的HTTPS请求、系统根证书过期、当前网络环境对境外站点的访问限制导致TLS握手失败。

方案1：临时使用国内PyPI镜像安装 #

直接执行以下命令即可完成安装，命令会跳过镜像的SSL校验，使用国内源拉取安装包：

pip install django -i http://pypi.douban.com/simple --trusted-host pypi.douban.com

方案2：永久配置国内PyPI镜像 #

Windows环境下按以下操作配置，后续所有pip安装操作都会默认走国内镜像，无需每次额外加参数：

1. 在用户目录（本次环境路径为C:\Users\rajesh-kumar）下新建名为pip的文件夹
2. 在pip文件夹内新建名为pip.ini的配置文件
3. 在pip.ini文件中写入以下内容：

[global]
index-url = https://pypi.douban.com/simple
[install]
trusted-host = pypi.douban.com

方案3：排查本地网络异常 #

如果上述方案无效，可按以下步骤排查：

• 暂时关闭本地全局代理、VPN、防火墙规则后重新尝试安装
• 先升级pip到最新版本后重试，升级命令：python -m pip install --upgrade pip

内容的提问来源于stack exchange，提问作者Rajesh Gupta