如何让pip wheel使用环境中已安装的内部依赖？解决whl构建报错

1. 让pip wheel使用本地已安装的内部依赖的方法 #

有几种实用方案，可根据你的需求选择：

• 跳过依赖检查直接构建：执行命令时添加--no-deps参数，跳过对依赖远程可获取性的验证，直接生成wheel包：

  pip wheel . --no-deps
  

  适合快速构建wheel，且不担心后续安装时依赖获取问题的场景。
• 指定本地依赖查找路径：如果foo包有对应的wheel或源码包存放在本地目录，用--find-links指定该路径，让pip优先从本地查找依赖：

  pip wheel . --find-links=/path/to/foo/package/directory
  

  你可以先给foo包构建一个wheel，放到指定目录中，这样pip就能找到它，不会再去远程PyPI查找。
• 修改包配置文件：在pyproject.toml中配置依赖查找路径（新版setuptools推荐方式）：

  [tool.setuptools.find-links]
  local-deps = "/path/to/foo/package/directory"
  

  后续执行pip wheel .时，pip会自动从指定路径查找foo包。

2. 为什么构建wheel会在意依赖是否可用？ #

虽然构建wheel只是生成包文件，不需要安装依赖，但pip在构建时会验证依赖的可获取性，核心原因有两点：

• 保障后续安装的有效性：wheel包的元数据包含依赖声明，pip会提前检查这些依赖是否能从默认索引（如PyPI）获取，避免生成一个他人安装时无法自动解决依赖的无效wheel。
• 适配部分特殊构建场景：如果你的包包含需要编译的扩展模块，构建过程可能需要依赖包的头文件或库文件，这时候依赖必须存在才能完成构建。你的情况属于依赖已本地安装，但未上传到公开索引的内部私有依赖场景。

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