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

Question

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

• vimdiff
• vimdiff1
• vimdiff2
• vimdiff3

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

Answer 1

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

相关源码在这里。请注意vimdiff、nvimdiff、 和gvimdiff是如何使用同一脚本实现的。

差异工具

当作为 difftool 调用时，它们都执行相同的操作：

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

这会以只读模式-R和 diff 模式启动 Vim -d。有关 diff 模式的信息，请参阅联机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，它使用与 -with-Base 相同的布局vimdiff，但省略 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，这将调用我们上面指定的命令。