?
This document uses PHP Chinese website manual Release
git-difftool - 使用常見差異工具顯示更改
git difftool [<options>] [<commit> [<commit>]] [--] [<path>…]
git difftool
是一個 Git 命令,允許您使用常見差異工具在修訂之間比較和編輯文件。git difftool
是前端git diff
并接受相同的選項和參數(shù)。參見 git-diff [1]。
-d --dir-diff
將修改后的文件復制到臨時位置,然后對它們執(zhí)行一個目錄 diff。該模式在啟動 diff 工具之前從不提示。
-y --no-prompt
啟動 diff 工具前不要提示。
--prompt
在每次調(diào)用 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
通過指定要在配置變量中調(diào)用的命令行,可以自定義運行其中一個已知的差異工具,以運行替代程序difftool.<tool>.cmd
。
當git difftool
用此工具調(diào)用(通過-t
或--tool
選項或diff.tool
配置變量)所配置的命令行將具有可用以下變量來調(diào)用:$LOCAL
被設置為包含DIFF前圖像的內(nèi)容的臨時文件的名字和$REMOTE
是設置為包含diff post-image內(nèi)容的臨時文件的名稱。$MERGED
是正在比較的文件的名稱。$BASE
是為了與自定義合并工具命令兼容而提供的,并且具有與$MERGED
相同的值。
--tool-help
打印可能使用的差異工具列表--tool
。
--no-symlinks
git difftool
默認行為是在--dir-diff
模式下運行時為工作樹創(chuàng)建符號鏈接,比較的右側產(chǎn)生與工作樹中文件相同的內(nèi)容。
指定--no-symlinks
指示git difftool
來創(chuàng)建副本。--no-symlinks
是Windows上的默認值。
-x <command> --extcmd=<command>
指定用于查看差異的自定義命令。git-difftool
忽略配置的默認值并$command $LOCAL $REMOTE
在指定此選項時運行。此外,$BASE
在環(huán)境中設置。
-g --no-gui
當git-difftool
使用-g
或--gui
選項調(diào)用默認差異工具時,將從配置的diff.guitool
變量中讀取,而不是從中讀取diff.tool
。該--no-gui
選項可用于覆蓋此設置。
--no-trust-exit-code
git-difftool
在每個文件上分別調(diào)用 diff 工具。默認情況下,diff 工具報告的錯誤將被忽略。使用--trust-exit-code
做出git-difftool
退出時調(diào)用的 diff 工具返回一個非零退出代碼。
git-difftool
將在--trust-exit-code
使用時轉發(fā)所調(diào)用的工具的退出代碼。
有關支持選項的完整列表,請參閱 git-diff [1]。
如果尚未定義difftool等價物,則git difftool
回退到git mergetool
配置變量。
diff.tool
要使用的默認差異工具。
diff.guitool
--gui
指定時使用的默認差異工具。
difftool.<tool>.path
覆蓋給定工具的路徑。如果您的工具不在 PATH 中,這非常有用。
difftool.<tool>.cmd
指定用于調(diào)用指定的 diff 工具的命令。
有關--tool=<tool>
更多詳細信息,請參閱上述選項
difftool.prompt
在每次調(diào)用 diff 工具前提示。
difftool.trustExitCode
如果被調(diào)用的 diff 工具返回非零退出狀態(tài),則退出 difftool。
有關--trust-exit-code
更多詳細信息,請參閱上述選項