VSCode diff视图跳动、卡顿或空白，主因是编码/换行符不一致、大文件超时（默认5000ms）、Git底层失败、干扰扩展（如GitLens）劫持流程，或误用内联diff路径；应统一编码、调高diffEditor.maxComputationTime、禁用干扰扩展、用命令面板触发真正diffEditor渲染链路。
怎么让 diff 视图不跳来跳去、卡顿或空白
VSCode 的 diffEditor 渲染卡顿或空白，多数不是性能问题，而是触发了保护机制或前置条件未满足。关键得先确认它是不是真在“渲染”，还是压根没拿到有效内容。
- 检查右下角状态栏：两边文件编码（如
UTF-8）和换行符（LF）必须一致，否则 VSCode 会静默跳过比对，显示为空白或“No differences” - 大文件（>1MB）默认被限流：
diffEditor.maxComputationTime默认是 5000ms，超时就停渲染；可在settings.json中设为15000临时缓解 - Git 层失败时，Diff 不报错只“Loading…”：终端进项目根目录执行
git show HEAD:src/main.ts，若失败，VSCode 就无法加载历史版本 - 禁用干扰扩展：尤其是 GitLens、Git Graph 等，它们可能劫持
Compare with Branch…行为，导致视图走内联模式而非侧边渲染
为什么 diffEditor.renderSideBySide 设为 true 还是上下排列
这个设置只控制“侧边并排”是否可用，不保证每次都会启用——实际布局取决于你**怎么打开**对比视图。
-
Git面板里点击M/A文件，走的是内联 diff 路径，完全无视diffEditor.renderSideBySide - 用命令面板执行
File: Compare Active File With或资源管理器多选后右键Compare Files，才真正走diffEditor渲染链路 - 某些扩展（如 Remote - SSH）会在连接初始化完成前强制 fallback 到上下布局，等几秒再右键 → “切换到并排视图”即可恢复
- 如果设置项在 UI 搜索中找不到，直接编辑
settings.json加入："diffEditor.renderSideBySide": true，避免同步或更新覆盖
怎么让空格、缩进、BOM 差异真正可见
diffEditor.ignoreTrimWhitespace 默认为 true，这是有意为之的设计，不是 bug。但调试配置或审查敏感文件时，你必须关掉它。
- 临时关闭：打开 diff 标签页 → 右上角
⋯→ 取消勾选Ignore Trimmed Whitespace - 全局关闭（慎用）：在
settings.json中设"diffEditor.ignoreTrimWhitespace": false，之后所有 diff 都会显示空格为浅灰点、\t为→、\n为¶ - BOM 差异不会被该选项捕获：需手动点击右下角编码标识 →
Reopen with Encoding→ 选UTF-8（非UTF-8 with BOM），两边都重开再比 - JSON/YAML 等结构化文件，先运行
Format Document统一缩进，否则空格差异会掩盖真实逻辑变更
合并后左侧文件没更新？别忘了这一步
VSCode 的 Accept Changes（✓ 图标）只是把右侧内容复制到左侧缓冲区，**不会自动保存**。这是最常被忽略的环节。
- 左上角文件名后出现
●，说明已修改但未保存；按Ctrl+S（Windows/Linux）或Cmd+S（macOS）才能写入磁盘 - 左侧是只读文件（如来自 Git 暂存区的干净版本）时，VSCode 会弹提示；此时需先取消文件只读属性，或用管理员权限打开文件夹
- 在 WSL 或远程开发场景下，检查左侧路径是否具有写权限：
ls -l看 owner/group，避免因 UID 不匹配导致保存静默失败 - 不要依赖
Auto Save：diff 合并不触发自动保存逻辑，必须手动确认
真正容易被忽略的是：Git 面板里的点击操作永远走内联 diff，它不受任何 diffEditor.* 设置影响；而真正的侧边并排渲染，只响应明确的“文件对比”动作——不是所有叫“diff”的界面，底层都走同一条渲染通道。
