什么是各种“vimdiff”difftools/mergetools？ vimdiffvimdiff1vimdiff2vimdiff3

如何解决什么是各种“vimdiff”difftools/mergetools？ vimdiffvimdiff1vimdiff2vimdiff3

当我运行 git difftool --tool-help 或 git mergetool --tool-help 时，我看到：

• vimdiff
• vimdiff1
• vimdiff2
• vimdiff3

这些不同的“版本”是什么？我假设他们都用不同的选项启动 Vim，但有哪些选项？他们在任何地方都有记录吗？

解决方法

不幸的是，它们似乎没有记录在任何地方。

相关源代码为here。请注意 vimdiff、nvimdiff 和 gvimdiff 是如何使用相同的脚本实现的。

差异工具

当作为 difftool 调用时，它们都做同样的事情：

vim -R -f -d \
  -c 'wincmd l' \
  -c 'cd $GIT_PREFIX' \
  "$LOCAL" "$REMOTE"

这会以只读模式 -R 和差异模式 -d 启动 Vim。有关差异模式的信息，请参阅联机帮助页 vimdiff(1) 和 Vim 帮助页 diff.txt。

合并工具

当作为合并工具调用时，这些选项的行为会有所不同。

在下图中，Local 对应“我们的”，Remote 对应“他们的”，Base 对应“合并基础”，Merge 是实际保存到工作树中的文件（如果解析成功则暂存到索引中）。

vimdiff

如果存在“合并基础”，则窗口布局为：

# | Local | Base | Remote |
# | --------------------- |
# |        Merge          |

vim -f -d \
  -c '4wincmd w | wincmd J' \
  "$LOCAL" "$BASE" "$REMOTE" "$MERGED"

如果不存在合并基础，则布局为：

# |       |       |        |
# | Local | Merge | Remote |
# |       |       |        |

vim -f -d \
  -c 'wincmd l' \
  "$LOCAL" "$MERGED" "$REMOTE"

vimdiff1

布局是：

# |       |        |
# | Local | Remote |
# |       |        |

vim -f -d "$LOCAL" "$REMOTE"
ret="$?"
if test "$ret" -eq 0
then
  cp -- "$LOCAL" "$MERGED"
fi

Local 将在成功后保存到工作树中，代替 Merged。

vimdiff2

布局与没有合并基础的 vimdiff 相同。

vimdiff3

Local、Remote、Base（如果存在）中的每一个都将被打开但隐藏。 Merged 将被打开并可见。您可以使用 :buffer 命令在这些缓冲区之间切换。

# With Base
vim -f -d \
  -c 'hid | hid | hid' \
  "$LOCAL" "$REMOTE" "$BASE" "$MERGED"

# Without Base
vim -f -d \
  -c 'hid | hid' \
  "$LOCAL" "$REMOTE" "$MERGED"

创建您自己的合并工具！

让我们创建一个 vimdiff4，它使用与 vimdiff-with-Base 相同的布局，但省略了 Base 部分。

将以下内容添加到您的 Git 配置（例如 $XDG_CONFIG_HOME/git/config）：

[mergetool "nvimdiff4"]
  # Like "nvimdiff",but always ignore $BASE.
  cmd = nvim -f -d -c '$wincmd w' -c 'wincmd J' $LOCAL $REMOTE $MERGED 

当您调用 git mergetool --tool-help 时，您将在输出中看到一个新行：

    user-defined:
        nvimdiff4.cmd nvim -d -c '$wincmd w' -c 'wincmd J' $LOCAL $REMOTE $MERGED

现在您可以运行 git mergetool --tool=nvimdiff4，它将调用我们上面指定的命令。