You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.25 13:13:25