如何合并多个pyproject.toml/Poetry依赖生成统一requirements.txt？

合并pyproject.toml文件 #

直接手动合并是可行的，但要注意几个核心细节：

• 把各个项目[tool.poetry.dependencies]、[tool.poetry.group.dev.dependencies]（新版Poetry）或[tool.poetry.dev-dependencies]（旧版）里的依赖项全部整合到同一个区块中。
• 处理版本冲突：如果同一个包在不同项目里的版本范围有冲突（比如一个要求==1.5，另一个要>=2.0），得手动协调成兼容的范围（比如升级其中一个项目的依赖到2.x，或统一用兼容的版本区间）；如果是兼容的范围（比如>=1.0和<2.0），直接合并为>=1.0,<2.0即可。
• 基础配置按需调整：[tool.poetry]里的name、version可以自定义，authors、license等信息根据需求保留或修改。

合并完成后，在新目录下执行poetry lock，让Poetry自动解析依赖并生成全新的lock文件，确保所有依赖能正常兼容。

合并poetry.lock文件（不推荐手动操作） #

poetry.lock是精确的依赖快照，包含包的具体版本、哈希值等关键校验信息，手动合并极易出现依赖冲突或哈希不匹配的问题，更稳妥的做法是：
基于合并后的pyproject.toml文件，直接运行poetry lock让Poetry自动生成统一的lock文件，这样能保证所有依赖版本的兼容性和合法性。

如果非要尝试手动合并，需要逐个对比多个lock文件的[[package]]区块，整合所有包条目，但必须保证同一个包的版本完全一致，同时更新[metadata]里的哈希和版本信息——这种方式出错概率极高，不建议使用。

生成统一的requirements.txt #

有两种可靠方式：

方式一：基于合并后的pyproject.toml/lock文件导出 #

1. 确保已经生成了统一的poetry.lock文件（推荐通过合并pyproject.toml后生成）。
2. 导出生产环境依赖：

   poetry export --without-hashes --format=requirements.txt > requirements.txt
   

3. 如需包含开发依赖，加上--with dev参数：

   poetry export --without-hashes --format=requirements.txt --with dev > requirements-dev.txt
   

方式二：逐个导出后手动合并 #

如果不想合并pyproject.toml，也可以给每个项目单独导出requirements.txt，再手动整合：

• 对每个项目执行poetry export --without-hashes --format=requirements.txt > proj-requirements.txt。
• 把所有proj-requirements.txt的内容合并到一个文件，去掉重复的包条目，手动处理版本冲突的包（选择兼容的版本）。

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