如何在VSCode中配置Git使用Beyond Compare作为默认的高级合并工具-VSCode-PHP中文网

git配置beyond compare必须指定完整可执行文件路径，且需同时配置diff和merge工具；vscode需关闭git.useeditorasdefaultdifftool并处理macos权限问题。

如何在vscode中配置git使用beyond compare作为默认的高级合并工具

Git 配置里 `beyondcompare` 的路径必须带完整可执行文件名

VSCode 本身不直接管理 Git 合并工具，它依赖系统级的 Git 配置。很多人配完没反应，第一原因是 git config 指向了目录而非具体二进制文件。Windows 上是 BCompare.exe，macOS 是 BCompare.app/Contents/MacOS/BCompare，Linux 是 bcompare（需确保在 $PATH 中）。

验证方式：在终端运行 which bcompare（macOS/Linux）或 Get-Command BCompare.exe（PowerShell），确认能返回真实路径。

常见错误配置：

git config --global diff.tool beyondcompare —— 这只是声明工具名，没告诉 Git 可执行文件在哪
路径写成 C:\Program Files\Beyond Compare 4\（缺 BCompare.exe）
macOS 上用了别名或软链但没指向 Contents/MacOS/BCompare

必须同时配置 `diff` 和 `merge` 工具才能支持比较与合并

VSCode 的「Git: Compare HEAD with Working Tree」走的是 git diff 流程，而解决冲突时调用的是 git mergetool，两者默认不共用同一套配置。只配一边，会发现一个能用、另一个报错或打开空白窗口。

正确做法（以 Windows 为例）：

git config --global diff.tool beyondcompare
git config --global difftool.beyondcompare.cmd '"C:/Program Files/Beyond Compare 4/BCompare.exe" "$LOCAL" "$REMOTE"'
git config --global merge.tool beyondcompare
git config --global mergetool.beyondcompare.cmd '"C:/Program Files/Beyond Compare 4/BCompare.exe" "$LOCAL" "$BASE" "$REMOTE" "$MERGED"'
git config --global mergetool.beyondcompare.trustExitCode true

注意点：

$LOCAL/$BASE/$REMOTE/$MERGED 是 Git 传给工具的固定占位符，大小写敏感，不能改
路径中含空格必须用双引号包裹整个命令，且内部反斜杠要转义或统一用正斜杠
trustExitCode true 表示信任 Beyond Compare 的退出码（比如用户点了 Cancel），否则 Git 可能误判为冲突未解决

VSCode 内置的「Open Changes With...」菜单不走 `git difftool`，得关掉它

即使 Git 配置全对，右键文件选「Open Changes With Beyond Compare」仍可能失败——因为 VSCode 默认用自己封装的 diff provider，绕过了你配的 git difftool。这个行为由设置项 git.useEditorAsDefaultDiffTool 控制。