最稳的vscode配置文件对比方式是先打开一个文件作为基准，再用命令面板执行“file: compare active file with”；该方式绕过路径、工作区等限制，只要文件在磁盘上即可100%触发。
VSCode 对比两个配置文件，最稳的方式不是右键“比较”，而是先打开一个作为基准，再用命令面板调出 File: Compare Active File With —— 这个动作能绕过路径、工作区、是否已打开等所有限制，只要文件在磁盘上，100% 可触发。
为什么右键菜单里总找不到 Compare 选项
资源管理器中单击一个文件右键，确实没有 Compare 相关项。这不是你漏看了，是 VSCode 的显式设计：只有按住 Ctrl（Windows/Linux）或 Cmd（macOS）多选两个文件后，右键任一文件才会出现 Compare with Selected。如果其中一个已打开且是活动标签页，这个菜单项反而会消失——它只认“纯文件选择态”，不认编辑器上下文。
- 单文件右键只有
Select for Compare，必须再选第二个并右键才能继续 - 从外部文件管理器（如 Finder / 文件资源管理器）拖入两个文件，只会各自开标签页，不会触发对比
- 路径含中文、空格、
%20或符号链接时，VSCode 可能静默失败（空白 Diff 视图），建议先复制到~/tmp/再试
File: Compare Active File With 命令灰掉的真正原因
这个命令不是全局可用的，它严格依赖两个条件：当前焦点必须在一个已保存的、有真实磁盘路径的文件编辑器中；且该文件不能是 Untitled-1 这类未命名临时文件。一旦焦点在终端、设置页、搜索框或空白编辑区，命令就会灰显。
- 安全做法：先点击目标配置文件 tab，确保边框高亮，再按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 如果刚新建了
config.json但还没保存，命令能触发但报错No file to compare with - 两个文件都未打开？别硬试——直接用终端执行
code --diff /path/to/a.json /path/to/b.json启动新窗口
对比结果全是红块？大概率是编码或换行符在捣鬼
配置文件（尤其是 JSON、YAML、.env）对字节层面极其敏感。一边是 UTF-8 BOM，另一边是 UTF-8 无 BOM；一边用 CRLF（Windows），另一边用 LF（Unix/macOS）——VSCode 不会自动转换，而是原样比对，导致整行偏移、中文乱码、空行标红。
- 看右下角状态栏：两边编码不一致？右键编辑器 →
Save with Encoding→ 都选UTF-8 - 换行符不同？点击右下角
CRLF或LF切换，两边统一设为LF - 缩进或末尾空格干扰判断？点 Diff 右上角 ⋯ → 取消勾选
Ignore Trimmed Whitespace，此时空格显示为浅灰小点 - 别手动删空行“对齐”——Diff 基于行哈希，空行本身是有效行
Diff 视图里改右边文件，真会覆盖原配置
很多人以为只是“看看区别”，结果手一滑点了 Ctrl+S，把右边 config.bak.json 的错误内容覆盖到了左边 config.json。尤其当文件名相似、路径接近时，极易误操作。
-
Ctrl+S默认只保存当前焦点侧（高亮边框那一侧），不是同时保存两边 - 点顶部
>图标可切换左右顺序，避免看反基准文件 - 右侧为备份或旧版本时，建议先右键 →
Duplicate Editor，再在副本里改，留原始文件兜底 - 关闭 Diff 视图后即销毁，不保留状态；想恢复原始布局，点顶部
×即可
配置文件对比最常卡在“看似没差异却满屏红块”，本质是底层字节不一致。VSCode 的 Diff 编辑器不隐藏细节，也不做猜测性修复——它只忠实呈现两个文件在磁盘上的真实差异。所以，动手前先盯一眼右下角的编码和换行符标识，比反复点右键有用得多。
