如何在同一目录下管理多个Python项目并共用统一requirements.txt？

直接将requirements.txt放在main目录是否合理？ #

直接放main目录是可用但存在适用边界的方案，如果你的三个Python项目永远绑定在一起开发、部署，不需要单独分发、单独对外提供，这种方案完全够用。
它的短板主要在以下场景：

• 单独拉取单个子项目运行时，找不到依赖声明文件
• 针对单个子项目做CI/CD校验、打包时，需要额外配置依赖文件的上级路径
• 子项目需要单独打包分发给第三方时，没法自动携带依赖声明

最佳实现方案 #

根据你的项目后续使用场景，可以从以下两种方案里选：

场景1：项目永久绑定开发部署，无单独分发需求 #

直接沿用根目录放requirements.txt的方案，补充2个优化点即可：

• 统一在main根目录创建、激活虚拟环境，安装依赖时执行pip install -r requirements.txt，所有子项目的运行、调试都基于根目录的虚拟环境执行
• 可在每个子项目目录下新建一个内容为-r ../requirements.txt的requirements.txt，这样在子目录下执行依赖安装命令也能正常识别依赖，不需要手动指定上级路径

场景2：后续存在单个子项目独立分发、单独上线的需求 #

更推荐用Python monorepo（单体仓库）的依赖管理机制，不需要额外引入复杂工具的话可以用如下方案：

• 根目录保留主依赖声明文件requirements.txt，所有公共依赖统一在这里管理
• 如果后续单个子项目出现独有的依赖，可新增requirements-项目名.txt单独存放该子项目的独有依赖，根目录的requirements.txt通过-r requirements-项目名.txt的方式引入所有子项目的独有依赖，仍然保持统一安装入口
• 要是你已经在使用Poetry、PDM等现代Python包管理工具，可以直接开启工具的工作区（Workspace）功能，在根目录统一声明所有依赖，工具会自动完成所有子项目的依赖共享，同时支持单个子项目单独打包时自动携带对应的依赖声明

注意事项 #

• 所有依赖的新增、升级、删除操作统一在根目录执行，禁止在子项目单独修改依赖配置，避免出现依赖版本不一致的问题
• 虚拟环境统一放在根目录创建，不要给每个子项目单独创建虚拟环境，保证依赖版本全局统一

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