Python中如何实现可选依赖Extras的级联安装？

问题根源 #

pip的依赖解析逻辑会优先满足install_requires中声明的基础依赖：当package1的install_requires已经指定了package2，即使extras_require里写了package2[extras]，pip会认为基础版package2已经满足依赖要求，不会自动安装带extras变体的package2及其依赖extra_package。

解决方案 #

方案1：调整package1的配置，区分基础与extras依赖

修改package1的setup.cfg，将基础依赖移到extras_require的单独项中，同时保留extras项的声明：

[options]
install_requires =
[options.extras_require]
base = package2
extras = package2[extras]

• 安装普通版package1：执行 pip install package1[base]，会安装package1+基础版package2
• 安装带全部extras的版本：执行 pip install package1[extras]，会安装package1+带extras的package2+extra_package

方案2：升级pip并优化依赖声明（推荐，无需修改安装命令）

1. 先升级pip到最新版本（旧版pip对extras依赖的解析存在缺陷）：

   pip install --upgrade pip
   

2. 修改package1的setup.cfg，在extras_require的extras项中给package2[extras]添加版本约束（确保pip识别为需要特定变体的依赖）：

   [options]
   install_requires = package2
   [options.extras_require]
   extras = package2[extras]>=0.0.1  # 替换为package2的实际版本号
   

   执行pip install package1[extras]时，pip会正确解析出需要安装带extras的package2，同步拉取extra_package。

方案3：临时强制更新依赖

如果不想修改配置，可通过pip参数强制重新解析依赖：

pip install --upgrade package1[extras]

该命令会强制pip升级package2到带extras的版本，同时安装extra_package。

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