pyproject.toml依赖包的子依赖未自动安装问题求助

为什么frozendict没被自动安装？ #

正常情况下，当你在pyproject.toml的project.dependencies中声明python-somepackage >=3.0.0时，pip会自动解析并安装该包的所有间接依赖（包括frozendict）。你遇到的问题大概率是以下原因之一：

• python-somepackage的包元数据存在问题：比如它的setup.py或自身的pyproject.toml未正确声明对frozendict的依赖，导致pip无法识别到这个间接依赖项。
• 本地pip缓存或安装异常：比如之前安装过不完整的python-somepackage，缓存中的元数据缺失依赖信息。可以尝试清理pip缓存后重新安装：

  pip cache purge
  python3 -m pip install -e .
  

• 你安装的python-somepackage版本实际未声明frozendict为依赖，但运行时却需要它——这种情况属于包本身的缺陷。

pyproject.toml中dependencies字段的作用 #

这个字段的核心作用是声明项目运行必需的直接依赖包，pip或其他Python包管理工具（如Poetry、Pipenv）会基于这些声明，自动解析并安装整个依赖链上的所有包（直接依赖+间接依赖）。具体来说：

• 明确告知包管理工具“我的项目要正常运行，必须具备这些包”
• 工具会负责处理依赖的递归安装，除非某个依赖包自身的依赖声明存在错误

是否需要使用requirements.txt？ #

分场景判断：

• 开发/本地调试场景：仅用pyproject.toml完全足够，不需要额外的requirements.txt。如果需要冻结当前环境的精确依赖版本（用于复现稳定环境），可以执行pip freeze > requirements.txt生成，但这并非强制要求。
• 生产部署场景：两种方式都可行：
  1. 直接使用pyproject.toml配合pip install .安装，依赖版本会遵循你在dependencies中声明的范围
  2. 用requirements.txt固定所有依赖的精确版本，避免不同环境因版本差异引发问题

如果确认python-somepackage确实需要frozendict但未声明，可临时将frozendict直接添加到pyproject.toml的dependencies中，强制pip安装它。

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