如何发布带相对路径依赖的Poetry管理Python包至PyPI

不需要借助sed等文本修改手段，Poetry本身有完整的原生能力覆盖这个开发场景，以下是两种可直接落地的稳定方案，均不需要手动切换配置：

方案1：路径依赖+版本约束双声明（推荐，Poetry 1.2+ 原生支持） #

之前的配置只声明了path字段，没有指定对应PyPI版本，所以构建时Poetry无法替换依赖。只要在同一条依赖配置里补上version约束即可：

[tool.poetry.dependencies]
python = "^3.7"
# 同时声明本地路径和对应发布版本约束
package_b = { path = "../package_b", develop = true, version = "^0.1.0" }

配置生效逻辑：

• 本地开发执行poetry install时，Poetry会优先加载相对路径下的package_b，以可编辑（editable/develop）模式安装，完全满足并行开发、不需要反复发布重装的需求
• 执行poetry build/poetry publish构建发布产物时，Poetry会自动丢弃路径相关配置，仅保留version约束写入包元数据，发布到PyPI后可以正常拉取对应版本的依赖，不会出现路径解析失败的问题
• 本地路径下的package_b版本号必须和你声明的version约束匹配，否则Poetry会直接抛出依赖校验错误，避免本地代码和发布依赖版本错配

方案2：依赖分组隔离（兼容Poetry 1.2以前的旧版本） #

如果用的是更早的Poetry版本，可以用依赖分组把开发用的路径依赖和发布用的正式依赖隔离开：

[tool.poetry.dependencies]
python = "^3.7"
# 发布时用的正式PyPI依赖
package_b = "^0.1.0"

[tool.poetry.group.dev.dependencies]
# 仅本地开发时启用的路径依赖
package_b = { path = "../package_b", develop = true }

配置生效逻辑：

• 本地开发时执行poetry install（默认会安装dev组依赖），本地路径的可编辑版本会覆盖远程版本，满足并行开发需求
• 构建发布时，Poetry只会读取主依赖组的配置，不会把dev组的路径依赖打进产物，完全符合PyPI的依赖规范
• 注意本地开发时不要加--no-dev参数，否则会安装远程版本的package_b，无法联动本地修改

其他说明 #

• 不要用sed等工具手动修改pyproject.toml切换依赖，这种方式很容易出现版本错配、配置改漏、改完未还原的问题，稳定性远低于原生方案
• 其他主流Python包管理工具比如uv、pdm对这个场景的支持逻辑和Poetry一致，都是通过路径+版本双声明的方式实现开发/发布场景的自动切换
• 不要把相对路径的包直接打包进package_a的源码里，会导致后续依赖版本升级、漏洞修复难以跟进，也不符合Python包的分发规范

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