如何向Git仓库首次提交添加文件并解决后续rebase合并冲突问题

冲突产生的核心原因是你在根提交新增了LICENSE文件后，后续历史提交中存在对LICENSE文件的修改、删除操作，变基时两个分支（新根提交分支和原有提交序列）对同一个文件的修改无法自动合并，就会触发冲突。

方案一：带合并策略的变基（适配原有操作习惯） #

• 先终止当前进行中的变基：git rebase --abort
• 重新执行指定冲突处理策略的变基命令：

git rebase -i --root -X theirs --rebase-merges

• 其中-X theirs参数表示出现冲突时优先采用原有提交序列的修改内容，可自动解决绝大多数LICENSE相关的冲突
• 还是按照原操作流程，将第一条提交的pick改为edit，添加LICENSE文件后执行：

git add LICENSE
git commit --amend --no-edit
git rebase --continue

方案二：使用git filter-repo批量修改（适配2000条提交的大仓库，效率更高） #

rebase操作遍历2000条提交耗时久且容易出现冲突，更推荐用专门的历史改写工具完成操作：

• 提前完整备份整个仓库，避免操作失误丢失数据
• 将准备好的LICENSE文件放到仓库外的固定路径（比如~/Desktop/LICENSE）
• 执行批量修改命令：

git filter-repo --tree-filter 'cp ~/Desktop/LICENSE .' --force

• 该命令会自动遍历所有历史提交，给每个提交都新增LICENSE文件，不会触发冲突，操作完成后所有提交都会包含该文件。

方案三：手动逐个处理冲突（适配冲突数量少的场景） #

• 出现冲突时执行git status找到标记为both modified的LICENSE文件
• 按照你的需求修改LICENSE文件到预期内容后执行git add LICENSE
• 执行git rebase --continue继续变基，重复该流程直到所有变基完成
• 你已经开启了rerere功能，第一次处理完某类冲突后，后续出现相同冲突会自动应用之前的解决规则，不需要重复手动修改。

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