macOS下Git difftool --dir-diff结合Beyond Compare显示文件异常问题

执行命令 git difftool --dir-diff HEAD^ HEAD 后，Beyond Compare能正常启动，但未正确展示两次提交间的文件差异，反而将文件当作独立文件进行对比。可通过以下步骤解决：

• 检查并修正Git配置
  打开终端，查看当前difftool相关配置：
  git config --list | grep difftool
  确保为Beyond Compare配置了正确的目录对比命令，macOS下配置示例：

  git config --global difftool.bc3.cmd '/usr/local/bin/bcomp "$LOCAL" "$REMOTE"'
  git config --global difftool.bc3.dircmd '/usr/local/bin/bcomp "$LOCAL" "$REMOTE"'
  git config --global difftool.prompt false
  

  重点是设置dircmd参数，确保Git调用Beyond Compare进行目录对比时使用正确的命令格式。

• 调整Beyond Compare的对比规则
  打开Beyond Compare，进入「偏好设置」（Beyond Compare > Settings），在「Comparison」选项卡中，勾选「Compare contents」，并将文件对比规则设置为「Compare by content」，避免仅通过文件名判断差异。

• 手动验证命令行目录对比
  直接用Beyond Compare的命令行测试目录对比功能，确认工具本身正常：
  bcomp /path/to/test/old/dir /path/to/test/new/dir
  如果此命令能正常展示目录差异，说明问题出在Git配置，重新设置上述dircmd参数即可。

• 清理Git临时文件（可选）
  Git使用--dir-diff时会生成临时目录，若残留文件导致异常，可执行以下命令清理未跟踪的文件和目录：
  git clean -d -f
  注意：执行前确认不需要保留未跟踪的文件。

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