VSCode提供四种Git合并冲突解决方式:一、用内置合并编辑器逐块接受变更;二、通过命令面板调用Git命令行工具;三、安装GitLens扩展增强差异比对与一键解决能力;四、配置VSCode为外部合并工具处理复杂文件冲突。

如果您在VSCode中执行Git合并操作时遇到代码冲突,编辑器会直观标记冲突区域并提供多种处理方式。以下是解决此问题的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、使用VSCode内置的合并编辑器
VSCode内置的可视化合并界面可清晰区分当前分支(CURRENT)与传入分支(INCOMING)的变更,并支持逐块接受或拒绝修改。
1、打开包含冲突标记的文件,VSCode自动高亮显示冲突区块,形如 >>>>> feature-branch。
2、点击冲突区块上方出现的“Accept Current Change”、“Accept Incoming Change”或“Accept Both Changes”按钮之一。
3、若需手动编辑,删除冲突标记符(>>>>>)并保留期望的代码逻辑。
4、保存文件后,VSCode自动将该文件从“MERGE_CONFLICT”状态移出。
二、通过命令面板调用Git命令行工具
当冲突涉及大量文件或需精细控制合并策略时,可借助Git原生命令配合VSCode终端完成操作,避免图形界面局限。
1、按下 Cmd+Shift+P(macOS)打开命令面板。
2、输入并选择“Git: Open Terminal in Repository Root”以定位至项目根目录。
3、执行 git status 查看处于 Unmerged 的文件列表。
4、对单个文件执行 git checkout --ours path/to/file 或 git checkout --theirs path/to/file 快速采用某一方版本。
5、执行 git add path/to/file 标记为已解决,再运行 git commit 完成合并。
三、安装并启用GitLens扩展增强冲突处理能力
GitLens扩展在编辑器侧边栏提供实时的变更来源追溯、提交历史比对及一键解决建议,显著提升多层嵌套冲突的判断效率。
1、在VSCode扩展市场中搜索 GitLens 并安装启用。
2、右键点击冲突文件中的任意一行,选择“GitLens: Compare With Branch…”并指定对比分支。
3、在弹出的差异视图中,勾选“Show Incoming Changes Only”聚焦传入变更。
4、使用右侧工具栏中的 Accept This Change 按钮直接插入选定行到当前文档光标位置。
四、配置自定义合并工具作为后备方案
当内置功能不足以应对复杂二进制或结构化文件(如JSON、YAML)冲突时,可将VSCode注册为外部合并工具,由其接管全部冲突解析流程。
1、在终端中运行 git config --global merge.tool vscode。
2、执行 git config --global mergetool.vscode.cmd 'code --wait $MERGED'。
3、发生冲突后,在终端输入 git mergetool,VSCode将自动打开三个临时文件:LOCAL、BASE、REMOTE。
4、在编辑器中手动整合内容至中间窗口(即 $MERGED 所指文件),保存并关闭所有窗口。










