Windows10下本地安装Python库失败求助（含numpy报错详情）

问题现象 #

• 执行本地源码包安装命令：

  pip install C:\Users\Tania\Downloads\numpy-1.23.1.tar.gz
  

  报错核心为网络连接失败（Errno 11001 getaddrinfo failed），无法下载构建依赖setuptools==59.2.0，最终导致安装中断。
• 直接执行pip install numpy也出现报错。

解决方案 #

1. 修复网络连接问题 #

• 验证网络连通性：打开浏览器访问PyPI的setuptools页面，确认能正常加载。若无法访问，排查本地网络、防火墙拦截或代理设置。
• 关闭代理：如果开启了VPN、全局代理，先关闭后重试pip命令。
• 切换国内PyPI镜像源（解决PyPI访问慢/失败问题）：
  • 临时使用镜像源安装：

    pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple
    

  • 永久配置镜像源：在Windows用户目录（C:\Users\你的用户名）下创建pip\pip.ini文件，写入以下内容：

    [global]
    index-url = https://pypi.tuna.tsinghua.edu.cn/simple
    

2. 本地源码包安装的正确流程 #

源码包需要编译，需提前确保构建依赖已就绪：

• 先升级构建依赖（网络正常时）：

  pip install --upgrade setuptools wheel
  

• 若网络仍无法访问PyPI，提前下载对应版本的setuptools wheel包到本地，先安装依赖：

  pip install C:\Users\Tania\Downloads\setuptools-59.2.0-py3-none-any.whl
  

• 再安装本地numpy源码包：

  pip install C:\Users\Tania\Downloads\numpy-1.23.1.tar.gz
  

3. 更简便的替代方案：使用预编译wheel包 #

源码包编译易出问题，推荐下载对应Python 3.10+Windows 64位的numpy预编译wheel包（如numpy-1.23.1-cp310-none-win_amd64.whl），直接本地安装：

pip install C:\Users\Tania\Downloads\numpy-1.23.1-cp310-none-win_amd64.whl

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