如何用外部Diff工具对比已移动/重命名文件的历史与当前版本

方案1：正确使用git difftool -M（推荐） #

Git的difftool支持和diff一致的重命名检测参数-M，之前的失效大概率是用法或配置问题。按以下步骤操作：

1. 先配置好你需要的外部Diff工具（以Meld为例）：

git config --global diff.tool meld
git config --global difftool.prompt false  # 取消每次启动工具的确认提示

如果你的Diff工具需要自定义启动命令，可补充配置：

git config --global difftool.meld.cmd 'meld "$LOCAL" "$REMOTE"'

2. 直接执行对比命令，只需传入历史提交SHA和当前文件路径：

git difftool -M <历史提交SHA> -- <当前文件路径>

Git会自动检测文件的重命名/移动历史，定位到该提交中对应文件的版本，然后启动你配置的外部Diff工具完成对比。

方案2：手动提取历史版本文件后对比（兼容所有场景） #

如果git difftool -M仍无法正常工作，可通过手动提取文件内容的方式实现对比：

# 1. 从指定提交中提取目标文件的历史版本到临时文件
git show <历史提交SHA>:<当前文件路径> > /tmp/historical-version.txt

# 2. 用你的Diff工具对比当前文件与临时文件（示例用Meld）
meld <当前文件路径> /tmp/historical-version.txt

# 3. 对比完成后可删除临时文件（可选）
rm /tmp/historical-version.txt

Git的git show <commit>:<path>会自动通过版本追踪定位到该提交中对应当前文件的版本，不受重命名/移动操作影响。

常见问题排查 #

之前git difftool -M失效的常见原因：

• Git版本过旧：部分旧版本difftool对-M参数支持不完善，建议升级到Git 2.20+
• Diff工具未正确配置：未设置默认difftool，或工具路径未加入系统环境变量
• 命令格式错误：遗漏--分隔符，导致Git误解析提交SHA和文件路径参数

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