根本原因是pip默认启用HTTPS证书验证，而网络环境（如公司代理、老旧系统OpenSSL或本地镜像源）无法正确验证PyPI或镜像站的TLS证书，导致SSL握手失败，常见错误为SSLError: certificate verify failed。
为什么 pip install 会报 SSL 证书校验失败？
根本原因是 pip 默认启用 HTTPS 证书验证，而你的网络环境（比如公司代理、本地镜像源、老旧系统 OpenSSL）无法正确验证 PyPI 或镜像站的 TLS 证书。常见错误信息是：SSLError: certificate verify failed 或 CERTIFICATE_VERIFY_FAILED。这不是 pip 本身出错，而是底层 SSL 握手被拒绝。
用 --trusted-host 临时绕过指定域名的证书检查
这个参数告诉 pip：对某个主机名不校验证书，仅适用于调试或受限网络。它不能加在 pip install 命令末尾就生效——必须放在对应源地址**之前**，且每个需要信任的域名都要单独写一次。
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn requests- 如果还走代理或中间有重定向，可能还需加
--trusted-host pypi.org和--trusted-host files.pythonhosted.org - 多个
--trusted-host可叠加，顺序无关，但必须紧贴-i参数之后或命令开头
永久配置比每次敲参数更可靠
临时加参数容易漏、易出错，尤其 CI/CD 或多人协作时。推荐改 pip 配置文件：
- Linux/macOS：编辑
~/.pip/pip.conf（不存在就新建） - Windows：编辑
%APPDATA%\pip\pip.ini - 在
[global]段下添加：[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn trusted-host = pypi.org trusted-host = files.pythonhosted.org
注意：trusted-host 是配置项，不是命令行参数，不要带 --；每行一个域名，不能用空格或逗号分隔。
比 --trusted-host 更安全的替代方案
跳过证书校验只是权宜之计，长期应优先修复根因：
- 升级 pip 和 Python：
python -m pip install --upgrade pip，新版 pip 自带更全的证书链 - 确认系统 CA 证书路径是否正确，Linux 可试
export SSL_CERT_FILE=/etc/ssl/certs/ca-bundle.crt（路径依发行版而异） - 某些内网环境应部署私有 PyPI 仓库并配置可信证书，而非全局禁用校验
用 --trusted-host 就意味着你主动放弃了某段连接的完整性保护，一旦该域名被劫持或证书被伪造，下载的包就可能被篡改——这点很容易被忽略。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
