VSCode 的 Merge Editor 可可视化解决 Git 合并冲突:启用后通过三栏比对(Current/Incoming/Result),点击图标选择保留内容,或用命令面板执行“Accept Current/Incoming/Both”策略,亦支持手动编辑 Result 栏后保存完成解决。

当您在 VSCode 中执行 Git 合并操作时,若多个分支对同一文件的相同区域进行了不同修改,系统会触发合并冲突。此时,“Merge Editor”提供可视化界面辅助您逐块比对并选择保留内容。以下是解决此类冲突的具体方法:
本文运行环境:MacBook Air,macOS Sequoia。
一、启用并打开 Merge Editor
Merge Editor 是 VSCode 内置功能,无需额外安装扩展,但需确保已启用 Git 集成且当前工作区处于冲突状态。触发后,VSCode 会自动提示打开合并编辑器,也可手动调用。
1、在源代码管理视图中,点击出现冲突的文件名右侧的“Accept Incoming”或“Accept Current”按钮旁的“Compare”链接。
2、若未自动弹出,右键冲突文件 → 选择“Open in Merge Editor”。
3、确认编辑器顶部显示为三栏布局:左侧为当前分支(Current),右侧为传入分支(Incoming),中间为合并结果(Result)。
二、使用三栏交互式合并
该模式允许您直观查看差异块,并通过点击操作直接将某一方变更写入结果区域,避免手动编辑文本带来的误操作风险。
1、定位到带橙色高亮边框的冲突块,其左右两侧分别显示 Current 和 Incoming 的不同内容。
2、将鼠标悬停在左侧内容块上,点击出现的 → 图标,将该块写入 Result 栏。
3、将鼠标悬停在右侧内容块上,点击出现的 ← 图标,将该块写入 Result 栏。
4、如需保留双方内容,可在 Result 栏中手动输入或粘贴组合后的代码,系统不会覆盖已有编辑。
三、使用命令面板快速应用预设策略
对于整文件级决策,可通过命令面板跳过逐块选择,直接采用统一策略生成结果,适用于明确倾向某一分支的场景。
1、按下 Cmd+Shift+P(macOS)打开命令面板。
2、输入并选择“Merge Editor: Accept Current Changes”。
3、或输入并选择“Merge Editor: Accept Incoming Changes”。
4、或输入并选择“Merge Editor: Accept Both Changes”,此时 Result 栏将尝试合并两方非重叠变更。
四、手动编辑 Result 栏并保存
Merge Editor 允许完全自由编辑中间结果栏,适合需要逻辑重构或语法修正的复杂冲突。编辑后保存即完成解决,Git 状态随之更新。
1、在 Result 栏任意位置双击进入编辑模式。
2、删除冗余行、调整变量命名、修复语法错误等操作均可直接进行。
3、确认无误后按下 Cmd+S 保存文件。
4、返回源代码管理视图,检查该文件状态是否由“Conflicting”变为“Merged”。










