如何让pip-compile输出宽松依赖，支持应用自主选择依赖版本？

核心问题分析 #

你当前的矛盾在于：库A作为被依赖包，用pip-compile生成了固定版本的requirements.txt，导致应用B指定同系列不同小版本的pandas时出现冲突。pip-compile的设计初衷是为应用生成锁定版本的依赖文件，确保环境一致性；但库的依赖应该是宽松约束，允许下游应用选择兼容的具体版本。

解决方案 #

1. 用库的标准依赖声明替代pip-compile生成的锁定文件（推荐）

库的依赖不应写在requirements.txt（这是应用的锁定文件），而是通过setup.py或pyproject.toml定义安装依赖，这样下游应用解析时会遵循宽松约束：

• 使用setup.py：

  from setuptools import setup
  
  setup(
      name="libraryA",
      version="1.1.1",
      install_requires=[
          "pandas~=1.4.0",  # 保留宽松约束
      ],
      # 补充其他必要配置（如packages、author等）
  )
  

• 使用pyproject.toml（PEP 621标准）：

  [project]
  name = "libraryA"
  version = "1.1.1"
  dependencies = [
      "pandas~=1.4.0",
  ]
  

发布库A后，应用B的requirements.in中指定libraryA==1.1.1和pandas==1.4.2时，pip-compile会自动识别两者兼容（均属于1.4.x系列），不会再抛出冲突。

2. 若需用pip-compile生成宽松约束文件（仅用于开发场景）

如果只是想在库A的开发环境中保留宽松依赖（不用于发布），可以通过约束文件配合pip-compile，但这种方式不适合发布给下游应用：

• 创建requirements-constraints.in文件，写入宽松约束：

  pandas~=1.4.0
  

• 运行pip-compile时指定约束文件：

  pip-compile --constraint requirements-constraints.in requirements.in
  

  不过这种方式仍可能生成部分固定版本，仅建议用于开发环境的依赖参考，不能替代库的标准依赖声明。

冲突的临时修复 #

如果暂时无法修改库A的依赖声明，可以在应用B的requirements.in中通过约束强制统一版本：

# requirements.in
libraryA==1.1.1
pandas==1.4.2
--constraint requirements-constraints.txt

但这只是权宜之计，根本解决还是要让库A使用宽松的依赖声明。

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