Git合并工具切换报错解决：kdiff3执行失败及merge.tool多值问题

我来帮你搞定这两个Git合并工具的问题，不管是修复kdiff3还是切换到p4merge，都有明确的步骤可以走：

方案一：修复kdiff3的执行格式错误 #

你遇到的Exec format error本质是Git（MinGW环境）无法正确识别kdiff3的路径格式，或者配置里的路径有误。按以下步骤调整：

1. 确认kdiff3的安装路径
   确保kdiff3确实安装在C:\Program Files\KDiff3\，并且存在kdiff3.exe（注意带.exe后缀，你的错误日志里写的是kdiff3，可能漏了后缀导致识别失败）。

2. 重新配置Git的kdiff3路径
   打开Git Bash，执行以下命令（二选一即可）：

   • 用Git兼容的Unix风格路径：

     git config --global mergetool.kdiff3.path "/c/Program Files/KDiff3/kdiff3.exe"
     

   • 用Windows格式路径（注意双反斜杠转义）：

     git config --global mergetool.kdiff3.path "C:\\Program Files\\KDiff3\\kdiff3.exe"
     

3. 设置merge.tool为kdiff3
   确保默认合并工具指向kdiff3：

   git config --global merge.tool kdiff3
   

4. 可选：配置kdiff3的启动命令
   为了更顺畅的合并体验，你可以自定义kdiff3的启动参数：

   git config --global mergetool.kdiff3.cmd '"/c/Program Files/KDiff3/kdiff3.exe" --auto --L1 "$MERGED (Base)" --L2 "$MERGED (Local)" --L3 "$MERGED (Remote)" -o "$MERGED" "$BASE" "$LOCAL" "$REMOTE"'
   

5. 测试修复效果
   在有合并冲突的仓库里执行git mergetool，如果kdiff3能正常启动并显示冲突文件，就说明修复成功了。

方案二：切换到p4merge解决多值覆盖问题 #

你遇到的merge.tool has multiple values错误，是因为Git配置里merge.tool被设置了多次，直接覆盖会失败，需要用--replace-all参数来统一设置：

1. 查看当前merge.tool的所有配置值
   先确认有哪些重复的配置：

   git config --global --get-all merge.tool
   

2. 统一设置merge.tool为p4merge
   使用--replace-all参数覆盖所有旧值：

   git config --global --replace-all merge.tool p4merge
   

3. 配置p4merge的路径
   假设p4merge安装在C:\Program Files\Perforce\p4merge.exe，执行以下命令配置路径（同样二选一）：

   • Unix风格路径：

     git config --global mergetool.p4merge.path "/c/Program Files/Perforce/p4merge.exe"
     

   • Windows格式路径：

     git config --global mergetool.p4merge.path "C:\\Program Files\\Perforce\\p4merge.exe"
     

4. 配置p4merge的启动命令
   添加自定义启动参数，让Git正确调用p4merge：

   git config --global mergetool.p4merge.cmd '"/c/Program Files/Perforce/p4merge.exe" "$BASE" "$LOCAL" "$REMOTE" "$MERGED"'
   

5. 可选：关闭工具选择提示
   如果不想每次执行git mergetool都确认工具，可添加：

   git config --global mergetool.prompt false
   

6. 测试p4merge
   同样在有冲突的仓库里执行git mergetool，验证p4merge是否正常启动并处理冲突。

内容的提问来源于stack exchange，提问作者Siddhartha esunuri