如何一次性检测私有PyPI源安装过程中缺失的所有依赖包（含间接及构建依赖）

我太懂你这种反复跑安装、每次只报一个缺失包的崩溃感了——尤其是那些藏在构建工具或者间接依赖里的包，比如你提到的hatchling需要的editables，真的要折腾好几次才能找全。下面给你几个亲测有效的方法，能一次性揪出所有缺失的包，包括间接依赖和构建阶段的依赖：

方法一：用pip-tools的pip-compile提前解析全量依赖 #

这是我最常用的方法，pip-compile会递归解析所有直接、间接，甚至构建系统的依赖，而且会一次性列出所有在你的私有源里找不到的包，不会半途而废。

• 首先如果你的环境里还没装pip-tools，要是能从公共源装的话就用pip install pip-tools，如果只能用私有源，那先确保pip-tools已经上传到你的私有源了。
• 然后在项目根目录运行这个命令，替换成你的私有源地址：

  pip-compile --index-url https://<my-artifactory>/artifactory/api/pypi/pypi-local/simple --extra-index-url https://<my-artifactory>/artifactory/api/pypi/pypi-local-external/simple pyproject.toml
  

• 运行后，如果有缺失的包，它会直接在控制台输出类似“Could not find a version that satisfies the requirement ”的错误，而且会把所有问题都列出来，不会只停在第一个。

方法二：增强版pip dry-run+详细日志捕获 #

之前你用--dry-run没得到有用的结果，大概率是因为没开足够详细的日志。试试加上多级verbose参数，把所有输出抓下来，就能找到所有缺失的包了：

• 运行这条命令，把输出保存到日志文件里：

  pip install -e ".[dev]" --index-url <你的私有源地址> --extra-index-url <你的外部源地址> --dry-run -vvv 2>&1 | tee pip-dry-run-log.txt
  

• 然后打开日志文件，搜索“Could not find a version that satisfies the requirement”这个关键词，所有匹配的行就是缺失的包，包括构建阶段的依赖。因为用了-vvv，pip会输出完整的依赖解析流程，不会漏掉构建工具需要的那些包。

方法三：如果用hatchling做构建工具，直接用hatch的依赖检查 #

既然你的项目用了hatchling，那可以直接用hatch自带的依赖检查功能，它会自动识别构建系统的依赖，而且一次性列出所有缺失的项：

• 首先在项目根目录的hatch.toml里配置你的私有源（如果还没配的话）：

  [tool.hatch.index]
  url = "https://<my-artifactory>/artifactory/api/pypi/pypi-local/simple"
  extra-urls = ["https://<my-artifactory>/artifactory/api/pypi/pypi-local-external/simple"]
  

• 然后运行这条命令，就能看到所有缺失的依赖了：

  hatch dep show missing --all
  

• 这个命令会把直接依赖、间接依赖，甚至构建系统需要的依赖都扫一遍，结果非常直观。

方法四：用pip download批量验证依赖 #

这个方法有点“笨”但很可靠，通过尝试下载所有依赖（包括构建依赖），一次性找出所有找不到的包：

• 首先先把你的项目构建依赖找出来，比如从pyproject.toml的[build-system]部分拿到需要的包，比如你用的是hatchling，那就是hatchling>=x.x.x。
• 然后运行这条下载命令，把构建依赖和项目的dev依赖一起传进去：

  pip download --dest /tmp/dummy --index-url <你的私有源> --extra-index-url <你的外部源> hatchling>=1.17.0 ".[dev]"
  

• 运行后，pip会尝试下载所有相关的包和依赖，如果某个包在你的私有源里找不到，会直接输出错误信息，所有缺失的包都会被列出来，不会只停在第一个。

一些额外的小提示 #

• 记得提前配置好私有源的权限，如果需要用户名密码的话，可以用pip config set global.index-url https://<用户名>:<密码>@<你的artifactory地址>/...来配置，避免每次命令都要输。
• 对于构建依赖，有些工具在dry-run模式下可能不会完全解析，所以优先用pip-compile或者hatch的方法，它们会直接读取pyproject.toml的build-system部分，不会漏掉构建阶段的依赖。

内容来源于stack exchange