如何在pyproject.toml中用pip-tools实现分层开发依赖锁定

核心结论 #

用pyproject.toml可选依赖组结合pip-tools的分层工作流是支持的，但你尝试将-c requirements.txt直接写入dev可选依赖组的做法不符合PEP508规范，所以会报错。不需要立刻转回requirements.in文件，调整命令用法即可实现需求。

原因分析 #

PEP508对pyproject.toml中的依赖项有严格格式要求，必须是合法的依赖声明（如requests>=2.25.0、pytest[cov]~=7.0），不允许直接写入pip的命令行参数（比如-c这种版本约束选项）。pip在解析pyproject.toml时会严格校验格式，因此直接写-c requirements.txt会触发错误。

可行方案 #

1. 将约束参数移到pip-compile命令中 #

保留pyproject.toml的可选依赖组（比如[project.optional-dependencies]下的dev组），编译dev依赖时，把-c requirements.txt作为pip-compile的命令参数传入，而非写入pyproject.toml：

# 先编译基础依赖生成requirements.txt
pip-compile pyproject.toml --output-file=requirements.txt
# 再编译dev依赖，同时用已生成的requirements.txt做版本约束
pip-compile pyproject.toml --extra=dev --output-file=requirements-dev.txt -c requirements.txt

这样既利用了pyproject.toml的分组管理，又实现了依赖版本的分层约束。

2. 复杂场景下转回requirements.in #

如果你的依赖声明包含大量自定义逻辑（比如多行注释、复杂条件依赖、非标准格式的约束），pyproject.toml的格式限制可能会带来不便。这种情况下转回requirements.in系列文件会更灵活，因为.in文件支持pip-compile扩展的语法（包括直接写-c约束），不需要严格遵循PEP508。

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