如何用Poetry为psycopg配置互斥的额外依赖？

需求概述 #

需要通过poetry install -E pgbinary或poetry install -E pgc命令，分别安装psycopg[binary]或psycopg[c]，同时要求这两个额外依赖互斥（同时安装时触发报错）。

初始配置的错误原因 #

最初的配置中，在[tool.poetry.extras]里直接写psycopg[binary]违反了Poetry规则——Poetry的extras列表仅允许引用已在[tool.poetry.dependencies]中声明的依赖名称，不能附加[extras]格式的后缀，这就是报错data.extras.pgbinary[0] must match pattern ^[a-zA-Z-_.0-9]+$的核心原因。

正确配置方案 #

通过Poetry的别名依赖和冲突约束功能，既能实现版本统一、依赖互斥，又符合psycopg官方推荐的extras使用方式：

[tool.poetry.dependencies]
python = "^3.9"
# 为psycopg的不同extras创建别名依赖，统一版本号
psycopg-binary = { package = "psycopg", version = "^3.1.0", extras = ["binary"], optional = true }
psycopg-c = { package = "psycopg", version = "^3.1.0", extras = ["c"], optional = true }

# 添加冲突约束，确保两个别名依赖无法同时安装
psycopg-binary = { conflict = "psycopg-c" }
psycopg-c = { conflict = "psycopg-binary" }

[tool.poetry.extras]
pgbinary = ["psycopg-binary"]
pgc = ["psycopg-c"]

配置说明 #

1. 别名依赖：通过package字段指定实际PyPI包为psycopg，同时为不同extras版本设置别名（psycopg-binary、psycopg-c），只需编写一次版本号即可统一管理。
2. 冲突约束：使用conflict字段声明两个别名依赖互斥，当尝试同时安装时，Poetry会直接抛出依赖冲突错误。
3. extras分组：将自定义的pgbinary、pgc extras分别关联到对应的别名依赖，保持用户安装命令的一致性。

验证步骤 #

• 安装psycopg[binary]：执行poetry install -E pgbinary，成功安装对应版本的带binary extras的psycopg。
• 安装psycopg[c]：执行poetry install -E pgc，成功安装对应版本的带c extras的psycopg。
• 尝试同时安装两个依赖：执行poetry install -E pgbinary -E pgc，Poetry会触发依赖冲突报错，符合互斥要求。

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