ERROR
pip
config_error
ai_generated
true
ERROR: Cannot install package-a==1.0 and package-b==2.0 because these package versions have conflicting dependencies. The conflict is caused by: package-a 1.0 depends on package-c[extra1]>=3.0 and package-b 2.0 depends on package-c[extra2]>=3.0. To fix this, you could try to: 1. loosen the range of package versions you've specified. 2. remove package versions to allow pip to attempt to solve the dependency conflict.
ID: pip/dependency-conflict-with-extras-syntax
80%Fix Rate
88%Confidence
1Evidence
2023-11-20First Seen
Version Compatibility
| Version | Status | Introduced | Deprecated | Notes |
|---|---|---|---|---|
| pip 23.0 | active | — | — | — |
| pip 23.3 | active | — | — | — |
| pip 24.1 | active | — | — | — |
Root Cause
Two packages require different extras of the same dependency package, and pip's resolver cannot install both extras simultaneously without a combined extra, leading to a dependency conflict.
generic中文
两个软件包需要同一个依赖包的不同 extras,而 pip 的解析器无法在没有组合 extra 的情况下同时安装这两个 extras,导致依赖冲突。
Official Documentation
https://pip.pypa.io/en/stable/topics/dependency-resolution/Workarounds
-
80% success Install the conflicting dependency with both extras using a combined specifier: pip install 'package-c[extra1,extra2]>=3.0' and then install the conflicting packages without version pins: pip install package-a package-b
Install the conflicting dependency with both extras using a combined specifier: pip install 'package-c[extra1,extra2]>=3.0' and then install the conflicting packages without version pins: pip install package-a package-b
-
85% success Create a virtual environment and use pip-compile (from pip-tools) to generate a resolved requirements.txt that includes both extras: pip-compile --extra=extra1 --extra=extra2 requirements.in
Create a virtual environment and use pip-compile (from pip-tools) to generate a resolved requirements.txt that includes both extras: pip-compile --extra=extra1 --extra=extra2 requirements.in
-
30% success Contact the maintainer of package-c to request a combined extra that includes both extra1 and extra2, or use a fork that merges them.
Contact the maintainer of package-c to request a combined extra that includes both extra1 and extra2, or use a fork that merges them.
中文步骤
使用组合说明符安装包含两个 extras 的冲突依赖:pip install 'package-c[extra1,extra2]>=3.0',然后安装冲突的软件包而不固定版本:pip install package-a package-b
创建虚拟环境并使用 pip-compile(来自 pip-tools)生成包含两个 extras 的已解析 requirements.txt:pip-compile --extra=extra1 --extra=extra2 requirements.in
联系 package-c 的维护者,请求一个包含 extra1 和 extra2 的组合 extra,或使用合并了它们的 fork。
Dead Ends
Common approaches that don't work:
-
Installing package-c[extra1,extra2] manually before the conflicting packages
85% fail
Pip's resolver still sees the conflict because it evaluates the full dependency tree; manual pre-installation does not override the resolver's logic and may lead to an inconsistent state.
-
Using --ignore-dependencies flag to force installation
90% fail
This can cause runtime import errors or broken functionality because the required extras are not installed correctly.
-
Downgrading both packages to versions that don't use extras
60% fail
Such versions may not exist or may introduce other security or compatibility issues.