VSCode需启用实验性三方视图:设置中开启git.mergeEditor为true并重启,仅在真实冲突时生效;左中右栏对应BASE/CURRENT/INCOMING,按钮操作以CURRENT或INCOMING栏内容覆盖最终文件。

VSCode 内置合并工具默认是两栏,怎么切到三方视图?
VSCode 默认的合并冲突解决界面确实是双栏(当前分支 vs 入站变更),不显示共同祖先。要启用三方视图(BASE / CURRENT / INCOMING),必须手动开启实验性功能——它目前仍被标记为 git.mergeEditor 实验开关,未默认启用。
- 打开 VSCode 设置(
Ctrl+,或Cmd+,),搜索git.mergeEditor - 勾选
Git: Merge Editor(注意:这是布尔开关,不是路径或字符串) - 重启 VSCode 或重新触发一次合并(比如
git merge --no-ff feature-branch)才能生效 - 该设置实际写入
settings.json后是"git.mergeEditor": true,别误写成"git.mergeEditor.enabled"等不存在的键
三方视图下,Accept Current Change 和 Accept Incoming Change 到底在改哪边?
界面左中右三栏对应 BASE(共同祖先)、CURRENT(你本地 HEAD)、INCOMING(待合并分支)。按钮文字容易误导:「Accept Current Change」不是“接受左边”,而是“把 CURRENT 栏的内容写入最终文件”;同理「Accept Incoming Change」是把 INCOMING 栏内容写入。这个逻辑和 Git 命令行 git checkout --ours / git checkout --theirs 严格对齐。
- 若你在 CURRENT 栏做了编辑,再点
Accept Current Change,会把你的修改 + 原 CURRENT 内容一并保留 - 点
Accept Incoming Change会完全丢弃 CURRENT 栏所有改动,只留 INCOMING 栏内容 - 没有「Accept BASE」按钮——BASE 是只读参考,不能直接提交
为什么点了 git.mergeEditor: true 还是看不到三方视图?
常见原因不是配置错,而是触发条件没满足:VSCode 的三方合并编辑器只在「有真正的冲突块」时激活。如果 Git 能自动合并(即使有改动),或者冲突已用命令行解决(.git/MERGE_HEAD 不存在),VSCode 就不会拉起该界面。
- 确保处于真实冲突状态:
git status显示Unmerged paths,且文件状态为both modified - 不要提前用
git add把部分冲突标记为已解决——这会让 VSCode 认为无需介入 - 检查是否禁用了 Git 扩展:三方视图依赖官方
Git扩展(IDgit),第三方 Git 插件可能绕过此机制 - Windows 用户注意:WSL 中执行的
git merge若未同步到 Windows 文件系统,VSCode(运行在 Windows 上)可能看不到冲突
三方视图和外部 diff 工具(如 Beyond Compare)能共存吗?
可以,但行为独立。VSCode 的 git.mergeEditor 只控制内置编辑器是否启用三方布局;外部工具由 git config merge.tool 和 git config difftool.prompt 控制,两者互不干扰。
- 想默认用三方视图处理冲突,但偶尔调外部工具:保持
git.mergeEditor: true,需要时右键冲突文件 →Open in External Diff Tool - 如果设置了
git config --global merge.tool bc3,命令行git mergetool仍会唤起 Beyond Compare,不影响 VSCode 内置界面 - 性能提示:三方视图加载比双栏略慢(尤其大文件),首次打开可能卡顿 1–2 秒,这是正常现象,不是配置失败


















