VS Code 解决 Git 合并冲突：从 Source Control 到提交核对

Git 合并冲突不一定要全靠命令行处理。VS Code 的 Source Control 视图会把冲突文件集中列出来，编辑器里可以直接选择当前分支、传入分支或手动合并后的结果。真正容易漏的不是“点哪个按钮”，而是解决后有没有核对：文件里不能再有冲突标记，Source Control 里不能再显示未解决冲突，提交前要确认变更内容。

本文按结果验收型操作指南来走：先说明最终要达到什么状态，再按 VS Code 的界面路径处理冲突，最后用 Source Control、编辑器搜索和终端状态做三次核对。

最终结果：冲突文件消失，提交记录清楚

处理完成后，应该看到三个结果：

• Source Control 面板里不再有 Merge Changes 分组。
• 冲突文件中没有 、=======、>>>>>>> 这类标记。
• 需要提交的文件已经暂存，提交消息能说明本次解决了什么冲突。

这也是本文的验收目标。不是把界面上的按钮点完就算结束，而是让仓库回到“可提交、可构建、可追踪”的状态。

操作流程：从 Source Control 打开 Merge Changes

打开 VS Code 后，左侧 Activity Bar 里选择 Source Control 图标。如果当前仓库处于冲突状态，面板中通常会出现 Merge Changes 分组，里面列出需要处理的文件。

推荐操作路径：

1. 点击左侧 Source Control 图标。
2. 展开 Merge Changes 分组。
3. 点击冲突文件，例如 src/user-service.ts。
4. 在编辑器中查看冲突块，确认 Current、Incoming 或 Result 区域。
5. 逐个冲突块选择保留内容，保存文件。

如果 VS Code 打开的是三栏合并界面，左侧和右侧通常用于对比两个来源，中间或下方用于查看最终结果；如果是普通文本冲突，编辑器会显示冲突标记和内联操作按钮。

中间状态：在编辑器里选择保留哪一侧

冲突块里经常会看到类似内容：

>>>>>> feature/profile-name

不要只按按钮名字机械选择。先看当前业务意图：

• Accept Current Change：保留当前分支的内容。
• Accept Incoming Change：保留合并进来的分支内容。
• Accept Both Changes：两边都保留，适合互不冲突的追加内容。
• 手动编辑：两边都不完全正确时，直接改成新的最终结果。

例如上面的例子，如果新分支已经把显示名改到了 user.profile.name，但当前分支的格式化函数仍然需要保留，最终可能改成：

return formatUserName(user.profile.name)

这一步的关键是保存文件后再继续下一个冲突块。不要在多个冲突文件之间来回切换后才统一保存，容易漏掉某个编辑状态。

结果核对：暂存前检查冲突标记和差异

解决完冲突后，先不要立刻提交。建议做三次核对。

第一，搜索冲突标记

在 VS Code 全局搜索里查这三个标记：

>>>>>>

如果搜索结果里还出现业务文件，说明仍有冲突块没有处理。注意 ======= 可能也出现在文档分隔线里，需要结合上下文判断。

第二，查看 Source Control 差异

回到 Source Control 面板，点击已修改文件查看差异。确认最终内容符合预期，没有误删函数、配置或测试数据。

第三，暂存并查看终端状态

确认无误后，在 Source Control 面板点击文件旁的加号暂存。也可以在 VS Code 内置终端运行：

git status

期望看到没有 unmerged paths 之类提示，冲突文件处于 staged 或 modified 状态，而不是仍然处于合并未完成状态。

异常修正：选错内容或仍有冲突怎么办

如果发现选错了内容，不要直接提交。可以按下面几种情况处理：

遇到复杂冲突时，可以先只处理一个文件，保存后运行相关测试或启动项目页面。确认没有问题后，再继续处理下一个文件。

归档记录：提交说明和后续追踪

提交前在 Source Control 面板输入明确的提交说明，例如：

fix: resolve profile name merge conflict

如果本次冲突来自某个功能分支合并，提交说明里最好写清楚解决范围。提交后再做一次状态检查：

git status

如果工作区干净，说明冲突处理、暂存和提交都已经完成。最后建议把本次取舍记录到团队任务或代码评审评论里，尤其是两边都改了同一段业务逻辑时，后续排查会更清楚。

总结一下，VS Code 解决 Git 合并冲突的重点不是“点 Accept 按钮”，而是完整闭环：Source Control 里定位冲突文件，编辑器里判断保留内容，保存后搜索冲突标记，再看差异、暂存、提交和状态。只要把结果核对做完整，冲突处理就不会留下半截状态。