VSCode自带文件对比和合并功能足够日常使用,但需理解触发场景:右键文件选“Select for Compare”再对比另一文件可手动比对;Git冲突时依赖标准标记自动激活合并按钮;文件夹对比需安装Compare Folders扩展;合并后须手动git add更新状态。

VSCode 自带的文件对比和合并冲突功能足够日常使用,不需要额外插件,但必须理解它在什么场景下生效、哪些操作会触发它。
如何手动触发两个文件的差异对比
VSCode 的 Compare Files 是纯本地比对,不依赖 Git 或其他版本系统。最常用的方式是:右键一个文件 → 选择 Select for Compare,再右键另一个文件 → 选择 Compare with Selected。此时会打开一个并排视图,显示行级差异,新增/删除/修改都会高亮标出。
- 支持任意两个文件(不同后缀、不同编码、甚至二进制文件也能尝试解析)
- 对比结果不可编辑;若要保存差异内容,需手动复制粘贴或使用
Copy All Changes命令(右键差异块) - 若文件过大(比如 >50MB),VSCode 可能拒绝加载,此时建议用命令行
diff或专用工具
Git 冲突时如何使用内置合并编辑器
当 Git 操作(如 pull、merge、rebase)产生冲突,VSCode 会在编辑器顶部显示 Accept Current Change / Accept Incoming Change / Accept Both Changes 等按钮。这些按钮只在文件中存在标准冲突标记(、=======、>>>>>> branch-name)时自动激活。
- 确保你的 Git 配置中设置了
core.editor="code --wait",否则终端里执行git mergetool可能打不开 VSCode - 如果没看到合并按钮,先检查文件是否真的含冲突标记——有时 Git 已静默解决部分冲突,或你误删了标记行
- 点击
Accept Both Changes不是简单拼接,而是按上下文智能插入,但对结构敏感的代码(如 JSON、YAML)仍可能出错,建议合并后手动验证格式
为什么“比较文件夹”功能默认不可用?
VSCode 原生不提供文件夹级差异对比(即不能直接右键两个文件夹点“Compare”)。这是有意设计,不是遗漏。若需要该能力,必须借助扩展:
- 官方推荐扩展
Compare Folders(by Peter J. Janke)可补全此功能,安装后右键文件夹会出现Compare with Folder... - 该扩展仅比对路径和文件名,不深入内容;若要内容级比对,仍需逐个打开差异文件再用
Compare Files - 注意:某些同步工具(如 Syncthing、rsync)的日志更可靠,VSCode 的文件夹对比更适合快速定位漏提交或误删
真正容易被忽略的是:VSCode 的合并编辑器不会自动刷新 Git 状态。改完冲突后,必须手动运行 git add ,否则 git status 仍显示 unmerged,且下次打开该文件时不会再次提示冲突按钮。









