Windows环境下Pip安装Python包失败求助

错误原因 #

公司代理服务器使用了旧版SSL协商协议，而Python默认禁用了不安全的旧协商机制，导致连接PyPI时出现[SSL: UNSAFE_LEGACY_RENEGOTIATION_DISABLED]错误。

可行解决方案 #

1. 临时关闭SSL验证（应急用） #

在PowerShell中先设置环境变量，再执行安装命令：

$env:PYTHONHTTPSVERIFY = "0"
py -m pip install pandas

注意：此方法会跳过SSL证书验证，仅适合临时使用，不建议长期开启。

2. 配置公司内部PyPI镜像（优先推荐） #

如果公司有内部PyPI镜像源，按以下步骤配置：

• 在用户目录下创建pip文件夹（例如C:\Users\你的用户名\pip）
• 新建pip.ini文件，写入以下内容（替换为公司实际镜像地址）：

[global]
index-url = http://公司内部镜像地址/simple/
trusted-host = 公司内部镜像地址

配置完成后，直接执行py -m pip install pandas即可通过内部镜像安装包。

3. 手动下载包本地安装 #

• 从PyPI官网下载对应Python版本和系统架构的包文件（.whl或.tar.gz格式）
• 在PowerShell中切换到包所在目录，执行本地安装命令：

py -m pip install .\pandas-2.1.4-cp311-none-win_amd64.whl

注意：替换上述命令中的文件名你实际下载的包文件。

4. 修改Python SSL配置（不推荐，仅应急） #

找到Python安装目录下的Lib\ssl.py文件，找到DEFAULT_CIPHERS的定义行，添加@SECLEVEL=1参数，示例：

DEFAULT_CIPHERS = "DEFAULT:@SECLEVEL=1"

修改保存后，再尝试执行pip安装。此方法会降低全局SSL安全级别，且Python更新后配置会失效，谨慎使用。

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