Git合并含重命名文件的分支后残留旧文件，如何仅保留新文件？

我们拥有main和development两个分支，日常在development分支开展开发工作，并定期将其合并至main分支。近期在development分支中，通过mv file_old file_new命令重命名文件，执行git add .并提交后Git已识别该操作为文件重命名，但执行git merge development --no-ff将development合并至main分支后，main分支同时存在旧文件与重命名后的新文件。需要找到更优方法，让合并后的main分支仅保留重命名后的新文件。

已执行操作 #

DEVELOPMENT分支操作

mv file_old file_new
git add .
git commit

MAIN分支操作

git merge development --no-ff

这种情况的核心原因是：main分支上的file_old在你从main切出development分支后，产生了新的提交修改，导致Git合并时无法直接匹配重命名操作，最终将旧文件（main有修改）和新文件（development新增）视为两个独立文件并存。

以下是几种可行的处理方案：

方案一：合并前置同步（推荐） #

在将development合并到main之前，先把main的最新代码同步到development，提前处理冲突：

1. 切换到development分支：

git checkout development

2. 合并main分支的最新代码：

git merge main

3. 此时Git会触发冲突提示，手动删除旧文件file_old，保留file_new：

rm file_old
git add .
git commit

4. 切换回main分支完成合并：

git checkout main
git merge development --no-ff

此方法能在开发分支提前解决问题，避免污染main分支的合并记录。

方案二：合并后直接清理 #

如果已经完成合并且出现新旧文件并存的情况，直接在main分支处理：

1. 删除旧文件：

rm file_old

2. 暂存修改并完成合并提交：

git add .
git commit

（若合并时处于冲突未完成状态，git commit会自动生成合并提交信息）

方案三：使用Git原生重命名命令 #

虽然Git可以识别系统mv的重命名操作，但直接使用git mv能更明确地告知Git这是重命名行为，降低合并时的识别歧义：

git mv file_old file_new
git commit -m "Rename file_old to file_new"

后续合并时Git会更精准地匹配文件变更，减少新旧文件并存的概率。

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