如何通过本地归档安装Python包？lxml等包安装遇连接超时问题

核心问题 #

安装lxml源码包（tar.gz）需要编译环境及Cython依赖，但网络无法连接PyPI下载依赖导致编译失败；直接在线安装也因网络超时无法完成。

解决方案 #

1. 优先使用预编译.whl包（无需编译，最简便） #

源码包需编译，离线环境下步骤繁琐，推荐下载对应Python版本和系统架构的预编译轮子文件：

• 确认Python版本：激活虚拟环境后执行python --version，例如Python 3.10对应标识cp310；64位系统对应win_amd64。
• 将下载好的lxml.whl和beautifulsoup4.whl放到本地目录（如./downloads/）。
• 进入虚拟环境，执行安装命令：

  py -m pip install ./downloads/lxml-5.1.0-cp310-cp310-win_amd64.whl
  py -m pip install ./downloads/beautifulsoup4-4.12.3-py3-none-any.whl
  

  注意替换为你实际下载的文件名。

2. 离线安装编译依赖（仅当必须使用tar.gz源码包时） #

若坚持使用源码包，需先离线安装编译依赖：

• 提前下载Cython>=3.0.7的安装包（.whl或tar.gz）到本地目录。
• 先安装Cython：

  py -m pip install ./downloads/Cython-3.0.10-py3-none-any.whl
  

• 再安装lxml源码包：

  py -m pip install ./downloads/lxml-5.1.0.tar.gz
  

  注：编译lxml还可能依赖libxml2、libxslt开发库，若出现相关报错，仍建议切换到预编译.whl包。

3. 基础环境检查 #

• 确保已激活venv虚拟环境：执行venv\Scripts\activate（Windows cmd），激活后命令行开头会显示(venv)标识。
• 若网络仅为临时故障，可尝试增加超时时间或使用国内镜像在线安装：

  py -m pip install lxml beautifulsoup4 --timeout=60 -i https://pypi.tuna.tsinghua.edu.cn/simple
  

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