pip check 报错不指明具体冲突包因只验顶层依赖，需用 pipdeptree --reverse --warn 定位；pip-tools 的 pip-compile 可深度解析依赖图并显式标出冲突。
pip check 为什么经常报错但不告诉你具体哪两个包冲突
pip check 只做顶层依赖兼容性验证，不展开子依赖树，所以它只会说 requests 2.31.0 is incompatible with urllib3=1.21.1 这类模糊提示，但不会指出是哪个第三方包把 urllib3 带进来的。
真实场景里，你装了 requests 和 botocore，后者锁死了 urllib3，而 <code>requests 新版又要求 urllib3>=2.0.0 ——pip check 就卡在这儿，只报冲突，不溯源。
- 它不解析
setup.py或pyproject.toml中的动态约束，只看已安装包的requires.txt元数据 - 如果某个包用
install_requires写了requests>=2.25.0，但没声明urllib3约束，pip check就完全看不到这层间接关系 - Windows/macOS/Linux 下行为一致，但 Python 3.8 之前版本可能因元数据缺失漏报
怎么快速定位真正冲突的包组合
靠 pipdeptree 配合 --reverse 和 --warn 才能挖出根因。先装工具：pip install pipdeptree，再执行：
pipdeptree --reverse --warn silence | grep -A5 -B5 "urllib3"
输出里会看到类似：
立即学习“Python免费学习笔记（深入）”；
├── requests [required: >=2.31.0, installed: 2.31.0]
│ └── urllib3 [required: >=2.0.0, installed: 2.0.7]
└── botocore [required: >=1.31.0, installed: 1.31.24]
└── urllib3 [required: <2.0.0,>=1.21.1, installed: 1.26.15]
-
--reverse显示谁依赖了某个包，比默认正向树更利于追因 -
--warn silence关掉无关警告，避免干扰关键路径 - 注意看
required:字段里的版本范围，不是installed:的当前值 - 如果
pipdeptree报No module named 'pipdeptree'，说明它没被 pip 正确识别为可执行模块，改用python -m pipdeptree ...
pip check 在 CI/CD 里容易误判的三种情况
pip check 默认只检查已安装包的静态元数据，对运行时动态加载、条件依赖、PEP 508 环境标记（如 platform_system == "Windows"）完全无感。
- 某个包在
pyproject.toml里写了requires-python = ">=3.9"，但你在 3.8 环境下跑pip check，它照样过，不校验 Python 版本兼容性 - 使用
extras_require安装的可选依赖（如pip install mypkg[dev]）不会被pip check扫描，除非你显式装了那些 extra 包 - 通过
pip install --find-links或私有 index 安装的包，若其requires.txt缺失或格式错误，pip check可能跳过校验，静默放行
替代方案：用 pip-tools 做更可靠的依赖锁定
如果你需要真正可控的依赖关系，pip-compile 比 pip check 更靠谱——它从 requirements.in 重新解析整个依赖图，生成带精确版本的 requirements.txt，并确保所有传递依赖都满足约束。
- 安装：
pip install pip-tools - 写
requirements.in，内容只需一行：requests>=2.25.0 - 运行：
pip-compile --generate-hashes requirements.in，输出里会直接标出冲突点，比如：Incompatible versions: requests 2.31.0 requires urllib3>=2.0.0, but botocore 1.31.24 requires urllib3 - 它默认启用
--upgrade，但加--no-upgrade可保留现有版本策略
真正难处理的是跨 Python 版本的兼容性问题，比如一个包在 3.9 下要求 typing-extensions>=4.0.0，但在 3.12 下又被标准库替代——这种细节 pip check 完全不碰，得靠 pip-tools 结合 --python-version 参数手动覆盖。
