git difftool

名称

git-difftool - 使用常见差异工具显示更改

概要

git difftool [<options>] [<commit> [<commit>]] [--] [<path>…​]

描述

git difftool是一个 Git 命令，允许您使用常见差异工具在修订之间比较和编辑文件。git difftool是前端git diff并接受相同的选项和参数。参见 git-diff [1]。

选项

-d --dir-diff

将修改后的文件复制到临时位置，然后对它们执行一个目录 diff。该模式在启动 diff 工具之前从不提示。

-y --no-prompt

启动 diff 工具前不要提示。

--prompt

在每次调用 diff 工具前提示。这是默认行为; 该选项用于覆盖任何配置设置。

-t <tool> --tool=<tool>

使用<tool>指定的 diff 工具。有效值包括 emerge，kompare，meld 和 vimdiff。运行git difftool --tool-help有效的<工具>设置列表。

如果没有指定 diff 工具，git difftool将使用配置变量diff.tool。如果配置变量diff.tool没有设置，git difftool会选择一个合适的默认值。

您可以通过设置配置变量明确提供工具的完整路径difftool.<tool>.path。例如，您可以通过设置配置 kdiff3 的绝对路径difftool.kdiff3.path。否则，git difftool假定该工具在 PATH 中可用。

git difftool通过指定要在配置变量中调用的命令行，可以自定义运行其中一个已知的差异工具，以运行替代程序difftool.<tool>.cmd。

当git difftool用此工具调用（通过-t或--tool选项或diff.tool配置变量）所配置的命令行将具有可用以下变量来调用：$LOCAL被设置为包含DIFF前图像的内容的临时文件的名字和$REMOTE是设置为包含diff post-image内容的临时文件的名称。$MERGED是正在比较的文件的名称。$BASE是为了与自定义合并工具命令兼容而提供的，并且具有与$MERGED相同的值。

--tool-help

打印可能使用的差异工具列表--tool。

--no-symlinks

git difftool默认行为是在--dir-diff模式下运行时为工作树创建符号链接，比较的右侧产生与工作树中文件相同的内容。

指定--no-symlinks指示git difftool来创建副本。--no-symlinks是Windows上的默认值。

-x <command> --extcmd=<command>

指定用于查看差异的自定义命令。git-difftool忽略配置的默认值并$command $LOCAL $REMOTE在指定此选项时运行。此外，$BASE在环境中设置。

-g --no-gui

当git-difftool使用-g或--gui选项调用默认差异工具时，将从配置的diff.guitool变量中读取，而不是从中读取diff.tool。该--no-gui选项可用于覆盖此设置。

--no-trust-exit-code

git-difftool在每个文件上分别调用 diff 工具。默认情况下，diff 工具报告的错误将被忽略。使用--trust-exit-code做出git-difftool退出时调用的 diff 工具返回一个非零退出代码。

git-difftool将在--trust-exit-code使用时转发所调用的工具的退出代码。

有关支持选项的完整列表，请参阅 git-diff [1]。

配置变量

如果尚未定义difftool等价物，则git difftool回退到git mergetool配置变量。

diff.tool

要使用的默认差异工具。

diff.guitool

--gui指定时使用的默认差异工具。

difftool.<tool>.path

覆盖给定工具的路径。如果您的工具不在 PATH 中，这非常有用。

difftool.<tool>.cmd

指定用于调用指定的 diff 工具的命令。

有关--tool=<tool>更多详细信息，请参阅上述选项

difftool.prompt

在每次调用 diff 工具前提示。

difftool.trustExitCode

如果被调用的 diff 工具返回非零退出状态，则退出 difftool。

有关--trust-exit-code更多详细信息，请参阅上述选项