如何在pyproject.toml中配置路径依赖：优先本地目录，降级到Wheel包？

你之前的写法之所以报错，是因为Poetry会把两个路径的依赖视为对同一个包的重复依赖——即使版本号完全一致，不同的文件来源也会触发版本解析冲突，导致依赖求解失败。

要实现「优先本地源码目录，不存在时降级到wheel包」的需求，最直接的方式是用Poetry的环境标记（environment markers），通过环境变量或平台信息区分开发/生产环境，指定不同的依赖源：

方案1：基于自定义环境变量切换 #

在pyproject.toml中配置依赖时，给两个来源分别加上环境标记，通过环境变量控制使用哪一个：

[tool.poetry.dependencies]
python = "^3.10"
base = [
  { path = "../../libs/base", develop = true, markers = "env('ENV') == 'development'" },
  { path = "dist/base.whl", develop = false, markers = "env('ENV') != 'development'" }
]

使用方式： #

• 本地开发时，设置环境变量后安装依赖：

  ENV=development poetry install
  

  此时Poetry会优先使用../../libs/base的源码目录，并且启用开发模式（修改源码会实时生效）。
• 生产环境部署时，切换环境变量或直接省略（默认走wheel包）：

  ENV=production poetry install --no-dev
  

  当本地源码目录不存在时，Poetry会自动匹配标记为生产环境的wheel包依赖。

方案2：基于操作系统平台切换 #

如果你的开发环境和生产环境操作系统不同（比如本地用macOS，生产用Linux），也可以直接用平台标记：

[tool.poetry.dependencies]
base = [
  { path = "../../libs/base", develop = true, markers = "sys_platform == 'darwin'" },
  { path = "dist/base.whl", develop = false, markers = "sys_platform == 'linux'" }
]

这种方式不需要手动设置环境变量，Poetry会根据当前系统自动选择依赖源。

补充说明 #

• 确保生产环境部署前，已经把base包构建成wheel并放到dist/目录下，构建命令：

  cd ../../libs/base
  poetry build --format wheel
  cp dist/base-*.whl ../projects/function-1/dist/
  

• 如果需要更灵活的切换逻辑，也可以结合Poetry的分组依赖，但环境标记是最简洁的实现方式。

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