必须显式调用对比命令才能进入真正对比模式：先打开一个文件，再通过命令面板执行“File: Compare Active File With”并选择另一文件，二者需均在工作区或已加载至VSCode缓存中，否则仅并排打开而无差异高亮。
怎么让两个文件真正进入对比模式，而不是单纯并排打开
VSCode 默认的“拖文件进标签栏”或“Ctrl+点击多个文件”只是并排打开，不会触发差异高亮。必须显式调用对比命令，否则看到的是两个独立编辑器，没有红/绿/黄差异标记。
正确做法是：
- 先确保至少一个文件已打开（或在资源管理器中选中）
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
File: Compare Active File With...并回车 - 从列表中选择另一个文件——注意：该文件必须已在工作区中，或已通过拖入/打开方式加载到 VSCode 缓存里
如果目标文件不在工作区，Compare Active File With... 列表里不会出现它，强行拖入也不生效。
为什么对比视图里右侧不能直接编辑，或者编辑后不保存
VSCode 的 diff 视图默认将右侧设为“只读参考”，尤其当右侧是 Git 历史版本、未保存临时文件或只读路径时。即使能点进去改，Ctrl+S 也会失败，并提示“无法写入只读文件”。
要修改右侧内容，得先退出 diff 视图：
- 关闭 diff 标签页（不是关闭单个编辑器面板）
- 在资源管理器中单独双击右侧那个文件，正常打开
- 编辑 → 保存
- 再重新执行
File: Compare Active File With...
例外情况：如果右侧是当前工作区中的普通文件且有写权限，VSCode 允许直接编辑并保存，但会弹出确认框提醒“正在修改原始文件”。这个行为容易被忽略，导致误覆盖。
对比大文件时报错“file is too large to compare”怎么办
VSCode 默认限制 diffEditor.maxFileSize 为 50MB，超过即禁用 diff 渲染，只显示“文件过大”提示，但文件仍可正常打开。
临时放宽限制的方法：
- 按
Ctrl+,打开设置 - 搜索
diffEditor.maxFileSize - 把值改成比如
100（单位 MB）
注意：调高后内存占用明显上升，尤其是含大量空行或重复结构的 JSON/YAML；若只是想看差异概览，建议改用终端命令：git diff --no-index file1.json file2.json | code -，它绕过 VSCode 的大小限制，且渲染更轻量。
如何让左右滚动同步，避免手动对齐差异行
默认 diff 视图左右独立滚动，查一个差异块就得来回拖动，效率极低。同步滚动不是默认开启的。
启用方式只有两种：
- 按住
Alt键（Windows/Linux）或Option键（macOS），再滚动鼠标滚轮——松开即恢复独立滚动 - 在 diff 视图右上角点击齿轮图标 → 勾选
Sync Scrolling（该选项仅在部分 VSCode 版本中可见，2026.4 稳定版已移至设置项diffEditor.renderSideBySide关联逻辑）
别依赖右键菜单里的“同步滚动”，那个选项在 diff 视图中实际不可见；也别指望设置里搜“scroll”就能找到，必须搜 diffEditor 才能定位到真实开关。
