使用pip通过终端安装numpy失败，求问题原因及解决方法

错误信息 #

WARNING: Retrying (Retry(total=0, connect=None, read=None, redirect=None, status=None)) after connection broken by 'ProtocolError('Connection aborted.', FileNotFoundError(2, 'No such file or directory'))': /simple/numpy/
ERROR: Could not find a version that satisfies the requirement numpy (from versions: none)
ERROR: No matching distribution found for numpy

可能的原因 #

• 网络连接异常：pip默认访问的PyPI官方源无法正常连接，可能是网络波动、防火墙/代理拦截，导致无法获取numpy的包索引。
• pip源配置错误：如果手动修改过pip的源地址，配置的源无效或路径错误，导致找不到numpy的包目录。
• 系统依赖缺失：系统缺少SSL相关组件等底层依赖，导致pip无法建立HTTPS连接，触发文件找不到的错误。
• pip版本过低：旧版本pip可能存在兼容性问题，无法正确解析PyPI的包信息。

解决步骤 #

• 切换国内PyPI源安装：执行带国内源的命令，直接绕过官方源的连接问题：
  pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
  常用国内源还有https://mirrors.aliyun.com/pypi/simple/、https://pypi.doubanio.com/simple/，可任选其一。
• 检查网络与代理：关闭防火墙、VPN等可能拦截网络的工具；若需使用代理，确保代理配置正确，可通过浏览器访问PyPI的numpy索引页验证网络是否正常。
• 修复pip源配置：
  • Linux/macOS：检查~/.config/pip/pip.conf文件，将index-url替换为国内源地址；
  • Windows：检查%APPDATA%\pip\pip.ini文件，修改或删除无效的源配置。
• 安装系统依赖（Linux）：执行sudo apt-get install openssl libssl-dev（Debian/Ubuntu系）或对应发行版的包管理命令，安装SSL相关依赖。
• 升级pip版本：先执行python -m pip install --upgrade pip，将pip升级到最新版本，避免版本兼容问题。

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