如何在develop/main分支中管理requirements.txt以避免合并冲突？

方案1：拆分需求文件 + 依赖锁定工具 #

把不锁版本的开发依赖和锁版本的生产依赖拆分为两个文件，借助工具自动生成生产环境的锁定版本文件：

• 维护一个通用的requirements.in文件，内容为不锁版本的包名，和当前develop分支的requirements.txt内容一致：

  package1
  package2
  package3
  

• develop分支直接用pip install -r requirements.in安装依赖，保持获取最新版本的特性。
• main分支使用pip-tools工具，基于requirements.in生成完全锁定版本的requirements.txt：
  1. 安装工具：pip install pip-tools
  2. 生成锁定文件：pip-compile requirements.in
     生成的文件会包含所有依赖的精确版本，和当前main分支的requirements.txt内容一致。
• 合并时，只需将develop分支对requirements.in的改动合并到main，再重新运行pip-compile生成新的锁定版本文件即可，完全规避冲突。

方案2：自定义Git合并驱动 #

通过配置Git的合并规则，让系统自动处理requirements.txt的冲突：

1. 在项目根目录创建自定义合并脚本（比如merge-requirements.py），核心逻辑：
   • 保留main分支中已有的包版本
   • 加入develop分支新增的包（可暂时用最新版本，之后再手动调整或用工具锁定）
   • 移除两边都删除的包
2. 在项目的.gitattributes文件中添加规则：

   requirements.txt merge=requirements-merge
   

3. 在Git项目配置中注册这个合并驱动：

   git config --local merge.requirements-merge.driver "python merge-requirements.py %O %A %B"
   

后续合并时Git会自动调用脚本处理冲突，无需手动修改。

方案3：分支专属需求文件 #

直接为两个分支分别维护独立的需求文件：

• develop分支使用requirements-dev.txt（不锁版本）
• main分支使用requirements.txt（锁版本）
• 各自分支安装依赖时使用对应文件即可，合并时两个文件属于不同资源，不会产生冲突，只需把develop分支新增的包同步到main的requirements.txt并锁定版本。

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