使用pip安装Python模块时遭遇SSL证书验证失败错误求助
解决pip安装Python模块时的SSL证书验证失败问题
这个问题是因为本地SSL证书链不完整,导致pip无法验证PyPI服务器的安全证书,所以安装任何模块都会失败。下面是几种可行的解决方法:
方法一:临时跳过SSL验证(应急用,不推荐长期使用)
执行安装命令时添加信任主机参数,跳过证书检查:
pip install pygame --trusted-host pypi.org --trusted-host files.pythonhosted.org
安装其他模块时,把pygame替换成对应的包名即可。
方法二:永久配置pip信任PyPI源
修改pip的配置文件,让它默认信任PyPI相关域名:
- Windows:在用户目录(比如
C:\Users\你的用户名)下创建pip文件夹,里面新建pip.ini文件,内容如下:
[global] trusted-host = pypi.org files.pythonhosted.org
- macOS/Linux:在用户根目录下创建
.pip文件夹,里面新建pip.conf文件,内容同上。
方法三:更新本地根证书
补充系统缺失的根证书,让pip能正常验证服务器证书:
- Windows:通过系统更新获取最新证书,或者手动下载并安装权威CA机构的根证书。
- macOS:如果是用官方安装包装的Python,找到Python安装目录下的
Install Certificates.command脚本并运行;或者打开“钥匙串访问”,导入缺失的根证书并设置为信任。 - Linux:更新系统证书包,比如Ubuntu/Debian执行:
sudo apt-get install --reinstall ca-certificates
CentOS/RHEL执行:
sudo yum update ca-certificates
方法四:改用国内PyPI镜像源(推荐,速度快还能规避证书问题)
国内镜像源通常不需要复杂的证书配置,而且下载速度更快:
临时使用
pip install pygame -i https://pypi.tuna.tsinghua.edu.cn/simple
永久配置
修改pip配置文件(同方法二的路径),添加镜像源地址:
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple
内容的提问来源于stack exchange,提问作者Sathya.1101
相关产品推荐
相关产品推荐

