如何将Araxis设置为MSYS git的差异/合并工具？

Question

我正在尝试使用 Araxis Merge 作为 MSYSGit 的差异/合并工具。

我在网上找到了一些资源：

• 在 Araxis 网站 上，他们提到了“简单”的方式，但它意味着可执行文件（araxisgitdiff.exe 和 araxisgitmerge.exe）不属于我的发行版。
• 我还在 gitguru，但关于：Araxis 的实际信息充其量是稀疏的，我无法从中得到任何信息。
• 最后，有一些关于较旧的 stackoverflow post，但建议的方法对我不起作用。 该特定信息是针对 OS X 的。我尽我所能“翻译”到 Windows，但没有成功：

我创建了 /bin/git-diff-driver.sh

#!/bin/sh

"/c/Program Files/Araxis/Araxis Merge/compare.exe" -title1:"$1 (repo version)" -title2:"$1 " -max "$2" "$5"

并编辑了 gitconfig

[merge]
    tool = araxismerge
[mergetool "araxismerge"]
    cmd = "/c/Program Files/Araxis/Araxis Merge/compare.exe" -3 -merge -wait $LOCAL $BASE $REMOTE $MERGED
[diff]
    external = "/bin/git-diff-driver.sh"

我得到的唯一结果是：

$ git diff HEAD^ HEAD
外部 diff 终止，停在 PowerEditor/src/Notepad_plus.cpp。

---

编辑：

我还按照答案之一的建议尝试了名为 "c:/Program Files/Araxis/Araxis Merge/compare.exe" 的 exe，得到了相同的结果。

---

编辑：

我发现如果您使用 TortoiseGit，可以轻松设置它，但它似乎可以自行处理 diff，并且 TortoiseGit 中的任何设置都没有给出任何指示，说明如何在从命令调用 diff 时将 Araxis 设置为合并工具线。

---

编辑：

所以，问题是：是否有人成功使用 Araxis Merge 与 MSYSGit 比较和合并内容，如果是这样，你是怎么做的？

Answer 1

如果你想让“git diff”始终使用 araxis，你可以使用帮助文件中的说明，但如果你想控制使用“git diff”，就像你通常从命令行和“git difftool”参与一样Araxis GUI。

尝试将以下内容添加到您的 git 配置中::

[difftool "araxis"]
    path = "/c/Program Files/Araxis/Araxis Merge/compare.exe"
    renames = true
    trustExitCode = true
[diff]
    tool = araxis
    stat = true
[mergetool "araxismergetool"]
    cmd = 'C:\\Program Files\\Araxis\\Araxis Merge\\araxisgitmerge.exe' "$REMOTE" "$BASE" "$PWD/$LOCAL" "$PWD/$MERGED"
    trustExitCode = false
[mergetool]
    keepBackup = false
[merge]
    tool = araxismergetool
    stat = true

Answer 2

araxis 的文档已更新： http://www .araxis.com/merge/documentation-windows/integrating-with-other-applications#Git

我可以使用那里显示的配置，无需任何修改。

Answer 3

是的...我让它工作了，使用 msysgit 版本 1.6.3.2.1299.gee46c，在 DOS 或 Git Bash 下，使用 Araxis Merge 2009，v2009.3713 的评估许可证：

该方法是使用新的 git difftool 和 git mergetool，而不是普通 diff 。

首先，让我们为这些 diff 和 merge 工具设置一些脚本

C:\>git config --global diff.tool adifftool
C:\>git config --global diff.external git-difftool--helper
C:\>git config --global difftool.adifftool.cmd "difftool.sh \"$LOCAL\" \"$REMOTE\" \"$MERGED\""
C:\>git config --global difftool.prompt false

注意：

• 通过将 diff.external 设置为 Git 脚本 git-difftool--helper，即使我输入 '，我也会使用 difftool git diff'。
• 不要忘记将 $MERGED 传递给 difftool 脚本：这是唯一具有所比较文件真实名称的变量。 $LOCAL 和 $REMOTE 是临时名称。

对于合并工具，您可以设置以下全局值：

C:\>git config --global merge.tool amergetool
C:\>git config --global mergetool.amergetool.cmd "mergetool.sh \"$PWD/$LOCAL\" \"$PWD/$BASE\" \"$PWD/$REMOTE\" \"$PWD/$MERGED\""
C:\>git config --global mergetool.prompt false

通过将这些工具设置为某些 shell 脚本，您将能够从这些脚本内切换工具。
另一种方法是命名您的工具（mergetool.araxis.cmd、mergetool.winmerge.cmd...）并在 diff 中指定正确的工具.tool 或 merge.tool 设置。

在全局环境变量 PATH 引用的目录中创建 difftool.sh 和 mergetool.sh。 它们甚至可以在 DOS 下工作（它们是 sh -- shell -- 脚本）

difftool.sh

#!/bin/sh
echo Launching Araxis Merge.exe: $3
t1="'$3 (from)'"
t2="'(to)'"
"C:/Program Files/Araxis/Araxis Merge/Compare.exe" -max -nowait -2 -title1:${t1} -title2:${t2} "$1" "$2" 

注意：

• 不可能有 -title1:" someTitle With Space"...只有没有空格的标题才有效...，所以现在，尝试不使用任何 'titleN' 选项。
  知道了！ 不能将标题值直接传递给 -title 选项，需要将其设置为局部变量，并用 "' '" 引号组合（双引号会消失）在 shell 脚本执行期间，保留简单的引号，并在标题中允许空格！）
• $3 代表真实名称，而不是用于比较目的的临时文件名。 因此，在 title1 选项中使用 $3，其中包含空格。
• git diff HEAD^ HEAD 在 DOS 会话中不起作用：只有 git diff "HEAD^" HEAD 可以。

mergetool.sh

#!/bin/sh

# Passing the following parameters to mergetool:
#  local base remote merge_result

alocal=$1
base=$2
remote=$3
result=$4

t1="'$4 (current branch)'"
t2="'(common ancestor)'"
t3="'(to be merged)'"

if [ -f $base ]
then
    "C:/Program Files/Araxis/Araxis Merge/Compare.exe" -max -wait -merge -3 -a2 -title1:${t1} -title2:${t2} -title3:${t3} "$alocal" "$base" "$remote" "$result" 
else
    "C:/Program Files/Araxis/Araxis Merge/Compare.exe" -max -wait -merge -3 -a2 -title1:${t1} -title2:${t2} -title3:${t3} "$alocal" "$result" "$remote" "$result" 
fi

我不确定这些脚本在涉及多个文件时是否能正常工作（多个差异、要合并的多个文件）。
刚刚测试过：它可以工作，并且 Araxiscompare.exe 确实为每个文件打开一个选项卡来比较或合并。
尝试一下并让我们知道;)

Answer 4

我认为你需要更加小心 .gitconfig 中的转义。

不幸的是，由于配置变量的扩展和评估方式，您的字符串需要是有效的 shell 命令，然后“git config”会被转义。

尝试这样的事情：

[mergetool "araxismerge"]
    cmd = \"/c/Program Files/Araxis/Araxis Merge/compare.exe\" -3 -merge -wait \"$LOCAL\" \"$BASE\" \"$REMOTE\" \"$MERGED\"

是的，不是很漂亮，我知道。 这是直接使用 git config 实际上更容易的情况之一。

git config --global mergetool.araxismerge.cmd '"/c/Program Files/Araxis/Araxis Merge/compare.exe" -3 -merge -wait "$LOCAL" "$BASE" "$REMOTE" "$MERGED"'

Answer 5

我在这个问题上挣扎了很长一段时间，现在我终于可以说，所有建议的脏黑客（如中间 shell 脚本）都是不必要的 =D。 事实是，所有最新版本的 MSYSGit（我有 1.6.4）都开箱即用地支持 Araxis Merge（我有 2008）。 毫不奇怪，它在内部被称为“araxis”。 因此，您所需要做的就是

[merge]
    tool = araxis

在 .gitconfig 中进行设置。 此外，您还必须将 Araxis 文件夹包含到 PATH 环境变量中（MSYSGit 查找 Compare.exe）。

作为一个好的措施，您可以配置的与“araxis”mergetool 相关的其他 Git 设置（特别是，如果您恰好选择了该名称，就像本页上的一些人一样），应该全部删除。 这包括 [mergetool "araxis"] 部分下的所有内容。 请务必从所有配置（系统、全局和存储库）中删除它们，否则它们可能会干扰正常的“内部工具”行为。

无论如何，如果您对 MSYSGit 如何启动 Araxis Merge 感兴趣，或者想知道它支持哪些其他开箱即用的合并工具，则可以查看 \share\git-gui\lib\mergetool.tcl MSYSGit 安装文件夹中的 脚本。

附言。 您可以通过在 .gitconfig 中配置 mergetool.araxis.path 来避免设置 PATH 环境变量。 就我个人而言，我从来没有费心这样做，因为

1. 我无论如何都从命令行使用 Araxis Merge。
2. 在 .gitconfig 中指定目录路径（尤其是像 "C:\Program Files\Araxis\Araxis Merge\" 这样包含空格的目录路径）可能很难正确完成，因为它很容易出现反斜杠/正斜杠问题，困扰着 MSYSGit。

聚苯硫醚。 上述所有内容也适用于使 Araxis 成为您的 difftool。 也就是说，如果您的配置中有的话，您需要在 [difftool "araxis"] 部分中添加

[diff]
    tool = araxis

和删除其他任何内容（不过，不要忘记设置 PATH）。

Answer 6

您可以尝试按照我的回答中提到的脚本进行操作diffMerge（适用于 Windows）并查看它是否有效。

可执行路径可以更好地表达为：

#!/bin/sh

"C:/Program Files/Araxis/Araxis Merge/compare.exe" -title1:"$1 (repo version)" -title2:"$1 " -max "$2" "$5"

Answer 7

我发现“简单”地做到这一点的一种方法是安装 TortoiseGit 并设置 diff /合并 TortoiseGit 选项中的工具。
但是，如果您想与命令行进行比较，这并不能解决问题。

Answer 8

由于我一直沉迷于定制的 git 差异/合并，我想我会尝试一劳永逸地解决这个问题。 我到达了 AraxisMerge 开始的地方，但没有选项卡的标题。 因此，这将作为读者的练习:)

观察和评论：

• 我没有 AraxisMerge，因此我下载了它并获得了 30 天的免费评估许可证来试用。 此版本（似乎是 7.0）附带 araxisgitdiff.exe，并且包含您发送的说明的链接有效。 所以这就是选项#1：升级 araxis merge。
• 由于我正在使用 CMD.EXE，因此“git diff HEAD HEAD^”不起作用。 '^' 需要转义为 'git diff HEAD "HEAD^"'。
• 对于我自己的工作，我使用 kdiff3 作为 Windows 上的免费替代品，它运行得相当好（它被 git 默认支持，这有帮助）

从 git-diff-driver.sh 开始给我带来了同样的错误。 将脚本更改为仅包含“echo”后，这并没有改变。 因此该错误与脚本的内容无关。

然后我从 .gitconfig 中删除了 '/bin' 部分，所以该行变成

external = "git-diff-driver.sh"

......并且这开始工作：它开始合并，但它没有正确转义 '(repo) ' 部分。 作为一种解决方法，我让它在没有标题的情况下工作：

#!/bin/sh
"/c/Program Files/Araxis/Araxis Merge/compare.exe" -max "$2" "$5"

祝你好运！