首页/开发/Git 与协作速查/git merge 重命名检测选项
合并变基与冲突71 条

git merge 重命名检测选项

合并时 Git 会尝试识别重命名并跨文件名合并;-X find-renames=<阈值> 调整敏感度,merge.renames 可关闭检测(不推荐)。

Git 与协作速查开发更新于 2026-10-12
用途控制合并中的重命名识别
语法git merge -X find-renames=40% <分支>
相关配置merge.renames(默认 true)

常用示例

常用示例
git merge -X find-renames=30% feature/rename-module
git log --follow --oneline src/new-name.js
改名同时大改内容最容易出现「改名 + 修改」双重冲突;先单独提交纯改名,再改内容,可显著降低合并难度。

易错点

  • 阈值调得过低会把不相关文件误判为改名,产生难以理解的冲突
  • 重命名检测只在合并/日志展示层面生效,仓库中并不存在永久性的改名记录

数据来源与参考

  • Git 官方文档:git-merge(find-renames)
  • Git 官方文档:git-log(--follow)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌