pip无法安装/升级包：遇OSError、SSL证书及哈希匹配问题

一、先排查网络拦截问题 #

你的跨系统（Windows、Linux、WSL）都出现相同问题，大概率不是单系统配置问题，先做以下检查：

• 确认是否存在全局代理、公司/校园网的中间人SSL拦截——这类场景常使用自签名证书，会篡改下载包导致哈希不匹配。
• 测试方法：切换到手机热点网络，直接执行pip install numpy（不加trusted-host参数），如果能正常安装，说明是当前网络的拦截问题。

二、BIOS虚拟机设置排查 #

针对你怀疑的BIOS设置，重点检查以下几项：

• 禁用Intel VT-d或AMD IOMMU：部分主板开启该虚拟化直通功能后，可能导致网络数据包处理异常，影响SSL证书验证和文件完整性。
• 关闭BIOS中额外的网络虚拟化子选项（比如Virtualization Technology下的细分开关），保存设置后重启系统再测试。
• 注意：修改前记录原有配置，避免影响VMware、VirtualBox等虚拟化软件的正常使用。

三、修复pip配置与哈希验证问题 #

如果网络和BIOS排查后仍有问题，调整pip全局配置：

1. 创建/修改pip配置文件：
   • Windows：在%APPDATA%\pip\pip.ini（不存在则新建）添加内容：

     [global]
     trusted-host = pypi.python.org
                    pypi.org
                    files.pythonhosted.org
     index-url = https://pypi.org/simple/
     

   • Linux/WSL：在~/.config/pip/pip.conf或~/.pip/pip.conf添加相同内容。
2. 强制跳过缓存重新下载：
   执行命令：pip install numpy --no-cache-dir，避免缓存的损坏包导致哈希不匹配。
3. 升级pip到最新版本：
   执行python -m pip install --upgrade pip --trusted-host pypi.python.org --trusted-host pypi.org --trusted-host files.pythonhosted.org，旧版pip可能存在哈希验证兼容性问题。

四、其他补充排查 #

• 检查系统时间是否正确：SSL证书验证依赖准确时间，若时间偏差过大（超出证书有效期范围），会直接触发验证失败。
• WSL环境：执行sudo hwclock -s同步硬件时钟到系统时钟，确保网络配置与主机同步。

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