vscode文件对比功能可用的前提是：当前编辑器聚焦于已保存的有路径文件，且两文件编码、换行符一致；资源管理器右键对比需精确选中同工作区两个文件；diff视图编辑时左右侧角色固定，修改后需手动保存。
VSCode 自带的文件对比功能完全够用，但必须满足几个硬性条件，否则 File: Compare Active File With 命令会灰掉、右键菜单不出现、或者比出来全是假差异。
命令面板触发失败？先确认焦点和文件状态
很多人输完 File: Compare Active File With 发现命令不可用，根本原因是 VSCode 没识别到“可比的上下文”：
- 当前编辑器必须聚焦在一个已保存的、有真实路径的文件上（
Untitled-1或未保存临时文件会失败） - 不能刚切到终端、设置页或搜索框就直接呼命令面板——得先点回文件标签，让光标落在代码里
- 如果两个文件都打开了，但没手动激活过任一标签（即没点过 tab），VSCode 也不会认为它是“active”
- 右下角状态栏显示
UTF-8 with BOM或CRLF而另一个是UTF-8/LF，也会导致命令执行后 diff 视图空白或报错
资源管理器右键 Compare with Selected 不见？检查多选和路径
这个选项不是默认隐藏，而是被 VSCode 严格限制触发条件：
- 必须按住
Ctrl（Windows/Linux）或Cmd（macOS）在资源管理器中**精确选中两个文件**——选一个或三个以上，菜单项直接消失 - 两个文件必须都在当前工作区根目录下（从桌面拖进来的独立文件、U 盘里的文件，右键无此选项）
- 文件名含全角空格、中文括号、
%20或符号链接时，VSCode 解析 URI 失败，可能静默不响应；建议先复制到~/tmp/或C:\temp\再试 - 右键前确保资源管理器已启用该功能：设置里搜
explorer.compareWith，确认Explorer: Compare With已勾选
Diff 视图全是红块/中文乱码/空行爆炸？本质是字节不一致
VSCode 的 diff 是基于原始字节流比对，不做自动编码转换。所谓“内容一样却差异满屏”，90% 是底层不一致：
- 右下角状态栏分别看两个文件的编码和换行符——一边
UTF-8 BOM、一边UTF-8，或一边CRLF、一边LF，立刻统一：右键编辑器 →Save with Encoding→ 都选UTF-8（不含 BOM），再点击右下角换行符标识切换成一致类型（推荐统一为LF） -
diffEditor.ignoreTrimWhitespace默认开启，尾部空格、行首缩进混用（空格 vs tab）会被忽略，导致关键差异漏掉；点 diff 视图右上角 ⋯ → 取消勾选Ignore Trimmed Whitespace，空格会显示为浅灰点，\t和\n差异也会标出 - JSON/YAML 等结构化文件若被 Prettier 格式化过，空行、逗号、缩进风格不同会淹没真实变更；比对前先关掉自动格式化，或用
prettier --write统一格式再比
对比时能改，但左右侧角色固定且不自动保存
Diff 视图不是只读预览，但编辑逻辑容易误操作：
- 左侧永远是“基准文件”（你最初打开或先选的那个），右侧是“目标文件”；顶部 > 图标可切换顺序，但不会改变角色定义
- 行号旁的
→按钮是把右侧改动**复制到左侧**，←是把左侧改动**复制到右侧**——按钮默认灰色，只有你手动编辑某行后才激活 -
Ctrl+S只保存当前焦点侧（高亮边框那一侧），不是两边一起存；想改右边文件，得先点它一下再按保存 - 关闭 diff 标签页即销毁会话，不会保留任何状态；改完记得手动保存对应文件，VSCode 不会帮你写回磁盘
最稳的路径其实是命令面板 + 手动确认状态栏编码/换行符 —— 这个组合几乎不受路径长度、空格、中文影响，也绕过了资源管理器多选的种种限制。真正卡住的时候，别反复试右键，先低头看看右下角那两行小字。
