mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-08 23:14:06 +08:00
1 line
7.4 KiB
HTML
1 line
7.4 KiB
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 [<options>] [<commit> [<commit>]] [--] [<path>…]</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 <tool> --tool=<tool></p></div></div><div class="doc-postil"><div class="c-markdown"><p>使用<tool>指定的 diff 工具。有效值包括 emerge,kompare,meld 和 vimdiff。运行<code>git difftool --tool-help</code>有效的<工具>设置列表。</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.<tool>.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.<tool>.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 <command> --extcmd=<command></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.<tool>.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.<tool>.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=<tool></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> |