vscode自带文件对比功能完全够用，但需满足三个硬性前提：至少一个文件已打开并处于焦点状态、两个文件编码和换行符一致、路径可被正确解析；缺一则会报错、灰显或出现假差异。
VSCode 自带的文件对比功能完全够用，不需要装插件或调外部命令——但必须满足三个硬性前提：至少一个文件已打开并处于焦点状态、两个文件编码和换行符一致、路径可被 VSCode 正确解析。缺一不可，否则会灰掉、报错或显示大量“假差异”。
Compare Active File With 命令为什么点不动
这个命令不是全局可用的，它只在编辑器有**激活文件**（即光标落在其内容中、标签页高亮）时才启用。常见失效场景：
- 两个文件都没打开 → 先 Ctrl+O 或拖进资源管理器打开一个
- 打开了但没点进去 → 单击该文件标签页，确保光标在编辑区里
- 焦点在终端/设置/搜索框 → 按
Ctrl+1（Windows/Linux）或Cmd+1（macOS）切回第一个编辑器组 - 文件路径含 URL 编码（如
%20）、全角空格或符号链接 → 复制到简单路径（如~/tmp/）再试
资源管理器右键 Compare Files 不出现怎么办
VSCode 的右键菜单不支持单文件触发对比，这是设计限制，不是 bug。正确操作路径是：
- 在资源管理器中按住
Ctrl（Windows/Linux）或Cmd（macOS），依次点击两个目标文件（顺序决定左右侧） - 右键任一被选中的文件 → 出现
Compare Files选项 - 如果只选了一个，右键只会看到
Select for Compare；必须再选第二个并右键选Compare with Selected - 两个文件不在同一工作区？VSCode 默认不显示跨工作区文件 → 先把目标文件拖进当前资源管理器，或用命令面板方式替代
对比结果全是红/绿块，中文乱码或空行标错
这不是差异，是比对基础被破坏了。VSCode 是字节级比对，编码或换行符不一致就会整行错位：
- 看右下角状态栏：确认两边都显示
UTF-8和LF（不是UTF-8 with BOM或CRLF） - 不一致就点开切换 → 右键编辑器 →
Save with Encoding→ 选UTF-8，两边都保存一遍 - 关闭
files.ignoreTrimWhitespace设置（默认为true），否则末尾空格差异会被隐藏，导致“看似没改却标为相同” - JSON/YAML 等结构化文件，先用
Format Document统一缩进再比，否则空行/缩进差异会淹没真实改动
大文件、未保存文件、剪贴板内容怎么比
原生能力有明确边界，强行突破会卡死或失败：
- 未保存文件（
Untitled-1）无法参与Compare Active File With→ 先Ctrl+S保存到临时路径（如/tmp/diff-test.js）再选 - 文件 >50MB → VSCode 会静默禁用 diff 计算，标签变灰 → 改用终端：
diff -u file1.js file2.js | less - 想比剪贴板？原生不支持 → 安装官方扩展
Code Diff，启用后右键编辑器即可选Compare with Clipboard - Git 历史版本对比，别用命令面板搜“compare”，直接输
Git: Compare HEAD with Working Tree
真正容易被忽略的是：对比视图不会自动刷新。外部修改了右侧文件，VSCode 完全无感知，必须手动重开对比；而且所有 diff 操作都是只读的，点 Accept 按钮只是把内容复制过去，不会自动保存，得自己按 Ctrl+S。
