各种"vimdiff"difftools/mergetools是什么？

Question

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

vimdiff
vimdiff1
vimdiff2
vimdiff3

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

Answer 1

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

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

差异工具

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

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

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

合并工具

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

下图中，Local对应“ours”，Remote对应“theirs”，Base对应“merge base”，Merge是将实际保存到工作树的文件（如果解析成功则暂存到索引）。

`vimdiff`

如果存在“合并基础”，window 布局为：

# | 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，这将调用我们上面指定的命令。

各种"vimdiff"difftools/mergetools是什么？

What are the various "vimdiff" difftools/mergetools?

git

vimdiff

mergetool