Git同一提交重命名文件并新建同名旧文件如何强制识别重命名

• Git本身不存储任何文件重命名的元数据，所有重命名识别全靠提交时/查询时对删除、新增文件的内容相似度比对，不存在可以直接写入提交的「强制重命名标记」。
• 直接用git mv解决不了当前场景的问题，它只是手动执行mv+git add+git rm的快捷封装，和手动重命名文件的效果完全一致，不会给Git传递任何「这是重命名」的特殊信号。
• 只要操作正确，识别到重命名后，git log --follow不会出现异常，历史追踪完全正常。

Git做重命名匹配有固定的优先级逻辑：

1. 优先匹配同路径变更：如果同一个路径下出现「旧版本删除、新版本新增」，会优先判定为该文件的内容修改，直接把这对变更排除出重命名匹配池
2. 剩下未配对的删除文件、新增文件，才会按内容相似度（默认相似度≥50%就算匹配）配对为重命名

你在同一提交里把原old_name重命名为new_name，又新建了同名的新old_name，Git第一步就会把「原old_name删除」和「新old_name新增」配对成「old_name文件被大幅修改」，剩下new_name成了无配对的新增文件，自然识别不出重命名，这也是你跑git commit -a --dry-run看到「文件修改+新文件新增」结果的原因。

核心思路是不要让新old_name的新增和原old_name的删除同时进入重命名匹配池，全程不需要拆分提交：

1. 先完成所有文件改动：将原old_name重命名为new_name，写好全新old_name文件的全部内容
2. 临时把工作区里新建的那个old_name重命名为临时名（比如old_name.tmp），确保当前工作区里不存在old_name路径的文件
3. 执行暂存操作：

   git add new_name
   git add old_name
   

   这时候工作区里没有old_name，Git会识别到原old_name被删除、new_name被新增，自动完成重命名配对，可以跑git status确认，会显示renamed: old_name -> new_name
4. 把临时名的old_name.tmp改回old_name，执行暂存：

   git add old_name
   

5. 正常提交即可，最终提交的变更会同时包含两条记录：old_name -> new_name的重命名、全新old_name文件的新增。

如果不要求必须在同一个提交里完成变更，最稳妥的方式是先单独提交old_name -> new_name的重命名，再提交新old_name文件的新增，不需要做临时改名操作，Git会100%自动识别重命名。

完全不会有异常，只要满足两个基础条件：

• 重命名后的new_name和原old_name的内容相似度达到本地配置的merge.renameThreshold阈值（默认是50%，正常重命名不改内容的话相似度100%，完全满足要求）
• 新old_name的内容和原old_name相似度足够低（如果新写的old_name和原文件内容一半以上都一致，Git可能在后续历史查询时错配，只要是全新编写的文件就不会有问题）

git log --follow的逻辑就是遍历提交时动态做重命名相似度匹配，只要提交里的文件内容符合相似度要求，追踪new_name的时候会正确关联到原old_name的全部历史，追踪新old_name的时候会从当前提交开始计算历史，不会出现串线、历史断裂的问题。

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