描述
git difftool是一个 Git 命令,允许您使用常见差异工具在文件之间比较和编辑文件。如两版本分支间需要比较合并可以用这个工具。
命令:
git difftool [<options>] [<commit> [<commit>]] [--] [<path>...
常见选项
-d --dir-diff
将修改后的文件复制到临时位置,然后对它们执行一个目录 diff。该模式在启动 diff 工具之前从不提示。
-y --no-prompt
启动 diff 工具前不要提示。默认是每次调用 diff 工具 前提示。
-t <tool> --tool=<tool>
使用<tool>指定的 diff 工具。有效值包括 bc, 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。
-g --no-gui
当git-difftool使用-g或--gui选项调用默认差异工具时,将从配置的diff.guitool变量中读取,而不是从中读取diff.tool。该--no-gui选项可用于覆盖此设置。
配置变量
如果尚未定义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。
使用
假如使用kdiff3作为比较工具
1. 下载kdiff3安装
windows:去官网下载双击安装。
Linux(Ubuntu):apt-get install kdiff3
2. 配置
我这儿配置成diff.guitool,而不是diff.tool是为了本机上即使不使用-t指定对比工具也有两个工具(kdiff3和vimdiff)可用。感觉更灵活些。
Windows:
git config --global --add diff.guitool kdiff3
git config --global --add difftool.kdiff3.path "C:/Program Files/KDiff3/kdiff3.exe" #软件安装的位置
Linux(Ubuntu):
git config --global --add diff.guitool kdiff3
git config --global --add difftool.kdiff3.path "/usr/bin/diff3"
我看很多文章上还像下边这样配置了一下,看了api文档没怎么看懂,测试发现不配也可以。
git config --global --add difftool.kdiff3.trustExitCode false
3.使用
同git diff的命令一样,可以自由在工作区,缓存区,版本库之间比较
比较两个版本分支指定目录(seal-pc)和文件(seal-page/a.js)的差异
git difftool branch1 branch2 seal-pc/ seal-page/a.js
此时使用的是vimdiff一个文件一个文件进行比较。每次文件比较前会提示将要比例的文件。vimdiff适合一个个文件比较时查看。
git difftool -y branch1 branch2 seal-pc/ seal-page/a.js
比较同上。只是每次文件比较前不会提示将要比例的文件
git difftool -g -d branch1 branch2 seal-pc/ seal-page/a.js
使用比较软件kdiff3一次打开所有差异文件进行比较。
因为配置了-d,所以会一次性加载所有的文件进行比较,不加则一个一个文件进行比较
因为配置了-g,所以使用刚才配置的kdiff3进行比较。此kdiff3的启动路径也是我刚才配置的path路径里的值。而不是使用的环境变量PATH里的。
如果使用diff.tool配置了多个比较工具,则使用git difftool命令时可以实用-t=工具名指定使用的比例软件。如 git difftool -t=bc -d branch1 HEAD seal-pc/ seal-page/ 使用beyound compare工具进行比较