pip 自 23.2 版本起正式支持级联可选依赖（cascaded optional dependencies），即 package1[extras] 可自动触发其依赖 package2[extras] 及其声明的 extra_package；旧版本（如 20.2）存在行为缺失，需升级 pip 或采用兼容方案。

pip 自 23.2 版本起正式支持级联可选依赖（cascaded optional dependencies），即 `package1[extras]` 可自动触发其依赖 `package2[extras]` 及其声明的 `extra_package`；旧版本（如 20.2）存在行为缺失，需升级 pip 或采用兼容方案。

在 Python 包生态中，通过 extras_require 实现可选功能模块是一种标准实践。但长期以来，pip install package1[extras] 并不会递归解析 package1 所依赖的 package2[extras] —— 即使 package1 的 setup.cfg 明确声明了 extras = package2[extras]，且 package2 自身定义了 extras = extra_package。这一行为并非配置错误，而是早期 pip（≤20.2）对依赖图中嵌套 extras 的解析逻辑不完整所致。

✅ 正确做法（推荐）：升级 pip 至 23.2 或更高版本

pip install --upgrade pip>=23.2
pip install package1[extras]

此时 pip 将按规范解析依赖链：

Ai Video Pipeline

对话式AI短视频创作工具：用户提出想法，Agent生成脚本，人工确认后自动生成MP4。触发条件：①制作视频/短视频；②AI旁白视频；③认知自述/播客风格视频；④文稿转视频。仅出现“视频”“TTS”“语音”等模糊词时不激活（可能是其他需求）。

下载

• package1[extras] → 触发 package2[extras]
• package2[extras] → 解析并安装 extra_package
  最终环境将同时包含 package1、package2 和 extra_package。

⚠️ 注意事项：

• 不要使用 pip install package1[extras] package2[extras] 手动补全——这虽能临时解决，但破坏依赖声明的单一信源原则，且易引发版本冲突；
• setup.cfg 中 extras = package2[extras] 的写法是标准且被现代 pip 支持的，无需改用 setup.py 或 pyproject.toml（尽管后者更推荐用于新项目）；
• 若受 CI/CD 环境限制无法升级 pip，请在 package1 的 extras_require 中显式声明下游 extras：

  [options.extras_require]
  extras = 
      package2[extras]
      extra_package  # 手动透传，确保兼容旧版 pip

? 总结：级联 extras 是 PEP 508 和 pip 后续迭代的重要增强。自 pip 23.2 起，该特性已稳定可用，开发者应优先升级工具链，而非绕过声明式依赖设计。验证是否生效，可通过 pip show package1 查看 Requires 字段，或运行 pip install --dry-run package1[extras] 观察拟安装包列表。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！