uTools-Manuals/docs/git/git difftool.html

<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>名称</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-difftool  - 使用常见差异工具显示更改</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git difftool [&lt;options&gt;] [&lt;commit&gt; [&lt;commit&gt;]] [--] [&lt;path&gt;…]</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git difftool</code>是一个 Git 命令，允许您使用常见差异工具在修订之间比较和编辑文件。<code>git difftool</code>是前端<code>git diff</code>并接受相同的选项和参数。参见 git-diff [1]。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>-d   --dir-diff</p></div></div><div class="doc-postil"><div class="c-markdown"><p>将修改后的文件复制到临时位置，然后对它们执行一个目录 diff。该模式在启动 diff 工具之前从不提示。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-y   --no-prompt</p></div></div><div class="doc-postil"><div class="c-markdown"><p>启动 diff 工具前不要提示。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--prompt</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在每次调用 diff 工具前提示。这是默认行为; 该选项用于覆盖任何配置设置。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-t &lt;tool&gt;   --tool=&lt;tool&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用&lt;tool&gt;指定的 diff 工具。有效值包括 emerge，kompare，meld 和 vimdiff。运行<code>git difftool --tool-help</code>有效的&lt;工具&gt;设置列表。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果没有指定 diff 工具，<code>git difftool</code>将使用配置变量<code>diff.tool</code>。如果配置变量<code>diff.tool</code>没有设置，<code>git difftool</code>会选择一个合适的默认值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>您可以通过设置配置变量明确提供工具的完整路径<code>difftool.&lt;tool&gt;.path</code>。例如，您可以通过设置配置 kdiff3 的绝对路径<code>difftool.kdiff3.path</code>。否则，<code>git difftool</code>假定该工具在 PATH 中可用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git difftool</code>通过指定要在配置变量中调用的命令行，可以自定义运行其中一个已知的差异工具，以运行替代程序<code>difftool.&lt;tool&gt;.cmd</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当<code>git difftool</code>用此工具调用（通过<code>-t</code>或<code>--tool</code>选项或<code>diff.tool</code>配置变量）所配置的命令行将具有可用以下变量来调用：<code>$LOCAL</code>被设置为包含DIFF前图像的内容的临时文件的名字和<code>$REMOTE</code>是设置为包含diff post-image内容的临时文件的名称。<code>$MERGED</code>是正在比较的文件的名称。<code>$BASE</code>是为了与自定义合并工具命令兼容而提供的，并且具有与<code>$MERGED</code>相同的值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--tool-help</p></div></div><div class="doc-postil"><div class="c-markdown"><p>打印可能使用的差异工具列表<code>--tool</code>。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-symlinks</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git difftool</code>默认行为是在<code>--dir-diff</code>模式下运行时为工作树创建符号链接，比较的右侧产生与工作树中文件相同的内容。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定<code>--no-symlinks</code>指示<code>git difftool</code>来创建副本。<code>--no-symlinks</code>是Windows上的默认值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-x &lt;command&gt;   --extcmd=&lt;command&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定用于查看差异的自定义命令。<code>git-difftool</code>忽略配置的默认值并<code>$command $LOCAL $REMOTE</code>在指定此选项时运行。此外，<code>$BASE</code>在环境中设置。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>-g   --no-gui</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当<code>git-difftool</code>使用<code>-g</code>或<code>--gui</code>选项调用默认差异工具时，将从配置的<code>diff.guitool</code>变量中读取，而不是从中读取<code>diff.tool</code>。该<code>--no-gui</code>选项可用于覆盖此设置。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-trust-exit-code</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git-difftool</code>在每个文件上分别调用 diff 工具。默认情况下，diff 工具报告的错误将被忽略。使用<code>--trust-exit-code</code>做出<code>git-difftool</code>退出时调用的 diff 工具返回一个非零退出代码。</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git-difftool</code>将在<code>--trust-exit-code</code>使用时转发所调用的工具的退出代码。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>有关支持选项的完整列表，请参阅 git-diff [1]。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>配置变量</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>如果尚未定义difftool等价物，则<code>git difftool</code>回退到<code>git mergetool</code>配置变量。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>diff.tool</p></div></div><div class="doc-postil"><div class="c-markdown"><p>要使用的默认差异工具。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>diff.guitool</p></div></div><div class="doc-postil"><div class="c-markdown"><p><code>--gui</code>指定时使用的默认差异工具。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>difftool.&lt;tool&gt;.path</p></div></div><div class="doc-postil"><div class="c-markdown"><p>覆盖给定工具的路径。如果您的工具不在 PATH 中，这非常有用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>difftool.&lt;tool&gt;.cmd</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定用于调用指定的 diff 工具的命令。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>有关<code>--tool=&lt;tool&gt;</code>更多详细信息，请参阅上述选项</p></div></div><div class="doc-postil"><div class="c-markdown"><p>difftool.prompt</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在每次调用 diff 工具前提示。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>difftool.trustExitCode</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果被调用的 diff 工具返回非零退出状态，则退出 difftool。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>有关<code>--trust-exit-code</code>更多详细信息，请参阅上述选项</p></div></div></div>