如何优化重命名并修改文件时的Git Diff显示？

核心解决方案 #

1. 用git mv命令明确记录重命名关系 #

不要手动修改文件名，而是用Git内置命令直接声明重命名操作：

git mv path/to/old-file.js path/to/new-file.ts

Git会在版本历史中直接标记这是一次重命名，后续对文件的修改提交后，Git和GitHub能更准确识别为「重命名+修改」，而非删除旧文件、新增新文件。

如果需要批量处理JS文件转TS，用shell命令批量操作：

# 递归处理src目录下所有.js文件
for f in src/**/*.js; do git mv "$f" "${f%.js}.ts"; done

2. 调整Git的重命名检测阈值 #

Git默认通过文件内容相似度判断重命名，默认阈值是50%——如果修改内容超过原文件的50%，Git会判定为新增/删除而非重命名。降低阈值能让Git更宽松地识别重命名：

# 仅当前项目生效
git config diff.renameThreshold 20

# 所有Git项目全局生效
git config --global diff.renameThreshold 20

设置为20%意味着，即使文件修改了80%的内容，Git仍会尝试识别为重命名。GitHub的PR差异展示依赖Git的检测结果，调整后PR就能正确显示重命名的上下文差异。

3. 更高效的拆分提交流程（无需新建分支） #

如果需要拆分重命名和修改的提交，不用新建分支，用git stash就能简化流程：

• 暂存当前已做的TS适配修改：

  git stash push -m "temp migration changes"
  

• 用git mv重命名目标文件，提交重命名操作：

  git commit -m "Rename JS files to TS for migration"
  

• 恢复暂存的修改，继续完成TS适配：

  git stash apply
  

• 完成后提交代码修改：

  git commit -m "Add TypeScript types and code adjustments"
  

这样在PR中，你可以直接聚焦第二个提交的变更，或者GitHub会自动识别重命名关系，展示带上下文的差异对比。

4. GitHub PR视图调整技巧 #

如果提交后PR仍显示为删旧加新，可尝试：

• 在PR的「Files changed」页面，点击右上角的...，选择「Hide whitespace changes」，减少干扰后更易识别重命名的差异；
• 切换到「Split」视图（默认是「Unified」），左右对比旧文件和新文件，GitHub会自动高亮重命名后的修改部分。

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