如何在pyproject.toml中指定PEP-508兼容的任意版本依赖？

问题分析 #

• 第一个依赖"first-example==*"触发错误：configuration error: project.dependencies[0] must be pep508，原因是==*不符合PEP508规范的版本约束格式。
• 第二个依赖"second-example"触发警告：warning: Missing version constraint (e.g., a lower bound) for second-example，这是工具的最佳实践提示，本身语法合法，但不符合版本约束的常规要求。

解决方案 #

要实现“接受任意版本”且符合规范，同时适配可编辑安装的包，有两种可行方式：

方式1：仅保留包名（简单直接） #

直接写包名本身就表示接受该包的任意版本，符合PEP508规范，且pip会优先使用本地已安装的可编辑版本：

dependencies = [
    "first-example",
    "second-example",
]

注：这种写法仍可能触发“缺少版本约束”的警告，但不依赖功能，仅为工具的最佳实践提示。若需消除警告，可使用方式2。

方式2：使用>=0.0.0约束（消除警告） #

用>=0.0.0明确表示接受所有版本（合法Python包版本号均≥0.0.0），既符合PEP508规范，也能消除版本约束缺失的警告：

dependencies = [
    "first-example>=0.0.0",
    "second-example>=0.0.0",
]

适配可编辑安装的说明 #

当你通过pip install -e /path/to/your/package安装了可编辑版本的包后，pip会自动优先使用本地的可编辑版本，无论依赖中指定的是哪种任意版本约束（只要约束不排除该版本），完全满足你的场景需求。

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