离线安装Python依赖报错：pip安装构建依赖子进程失败

• 补全构建依赖包
  错误根源是安装源码包（如ansible-vault-2.1.0.tar.gz）时缺少wheel这类构建依赖。pip freeze生成的清单不包含构建类依赖，需额外处理：

  • 在联网机器单独下载wheel：pip download wheel，将得到的包放到目标机器依赖目录
  • 或初始下载时一并拉取构建依赖：pip download -r requirements.txt --build

• 禁用构建隔离
  若目标机器已安装wheel和setuptools，安装时添加--no-build-isolation参数，跳过构建依赖的自动安装：

  pip install --no-index --find-links=. --no-build-isolation -r requirements.txt
  

  注意：需确保当前环境的setuptools、wheel版本满足包的构建要求。

• 优先下载预编译wheel包
  源码包需要本地构建，易触发依赖问题。联网下载时用--prefer-binary优先拉取预编译包，减少构建需求：

  pip download -r requirements.txt --prefer-binary --dest ./deps
  

  复制整个deps目录到目标机器后执行安装。

• 验证依赖完整性
  在联网机器先模拟离线安装：pip install --no-index --find-links=./deps -r requirements.txt，提前排查包缺失或损坏问题。

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