使用git mv重命名文件后，Git显示文件内容全量变更的问题排查

你的操作核心问题在于误解了Git重命名追踪的工作逻辑：Git不是靠文件名变更记录来追踪文件历史，而是通过文件内容的相似度来识别重命名/文件继承关系的。

你的操作为什么出问题： #

• commit1：提交mainV1.py（内容是V1版本）
• commit2：git mv只是修改了文件名，文件内容还是V1版本。这时候Git标记为重命名是对的，但内容没变化，diff自然是全量重命名（因为只是文件名变了）
• commit3：用完全不同的V2内容替换掉了mainV2.py，这相当于直接覆盖了文件内容，此时mainV2.py的内容和commit1的mainV1.py差异极大
• 后续对V3的操作同理，commit4是重命名mainV2.py到mainV3.py（内容还是V2），commit5替换成V3内容

当你对比commit1和commit3时，Git会尝试找两个版本间的文件关联，但commit3的mainV2.py和commit1的mainV1.py内容差异已经超过了Git默认的相似度阈值（默认是50%），所以Git会认为这是两个完全无关的文件，显示全量变更。

而git log --follow之所以只能查到commit1、3、5，是因为commit2只是重命名（内容没改），commit4也是重命名（内容是V2），但commit3和commit5是内容全换，Git无法通过内容关联把commit2、4纳入追踪链。

正确的做法： #

如果你想追踪V1→V2→V3的变更历史，应该直接在同一个文件上迭代修改：

1. 提交main.py（V1版本，commit1）
2. 修改main.py为V2版本，提交（commit2）
3. 再修改main.py为V3版本，提交（commit3）

这样无论是git diff commit1 commit3还是git log --follow -- main.py都能正常追踪变更。

如果需要保留不同版本的文件（比如同时存在mainV1.py、mainV2.py、mainV3.py），应该直接分别提交每个文件，而不是用重命名再替换的方式：

• 先提交mainV1.py（commit1）
• 添加mainV2.py并提交（commit2）
• 添加mainV3.py并提交（commit3）

此时可以用git diff mainV1.py mainV2.py直接对比两个文件的差异，Git会正确显示行变更。

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