VSCode内置diff工具不显示差异，主因是编辑器被设为只读、禁用差异渲染、语言模式错误、Git换行符配置冲突、外部diff工具未集成至UI、文件超50MB限制或二进制文件被跳过。
VSCode 内置 diff 工具不显示差异
vscode 的 git diff 或文件对比（file: compare active file with...）突然空白、无高亮、无变更行标记，大概率不是插件冲突，而是当前编辑器视图被意外设为「只读」或「禁用差异渲染」。检查右下角状态栏：若显示 read only 或 diff 按钮灰掉，说明编辑器已进入非 diff 模式。
- 快捷键
Ctrl+K Ctrl+D（Windows/Linux）或Cmd+K Cmd+D（macOS）强制触发当前文件与暂存区的 diff，绕过右键菜单逻辑 - 确认当前文件未被打开为「Plain Text」模式——点击右下角语言模式标签（如
Plain Text），切换为对应语言（如JavaScript），否则语法感知失效会导致 diff 高亮不生效 - 临时关闭所有非必要扩展：尤其是
GitLens、Compare Folders类插件，它们可能劫持vscode.diff命令注册表
Git diff 显示 “No changes” 但实际有修改
执行 git status 能看到修改，但 VSCode 源代码管理视图或内联 diff 中仍显示无变更，常见于 Git 配置项 core.autocrlf 或 core.filemode 不一致导致的「假干净」状态。
- 运行
git ls-files --modified确认 Git 是否真认为文件已修改；若为空，执行git add --renormalize .重应用换行符规则 - 检查
.gitattributes是否存在全局* text=auto eol=lf规则，与当前系统换行符冲突（如 Windows 上强制crlf但文件已存为lf） - 在 VSCode 设置中搜索
git.detectSubmodules，设为false——子模块路径误判有时会阻断主仓库 diff 渲染
自定义 diff 命令（如 meld、p4merge）无法调用
配置了 git config --global diff.tool meld 并在 VSCode 中启用 git.terminalAuthentication，但点击「Open Changes」仍弹出内置 diff，说明 VSCode 并未将外部 diff 工具集成进其 UI 流程，仅影响终端 git difftool 行为。
- VSCode 的图形化比较功能（右键 →
Compare with Saved）**完全不走 Git 的diff.tool配置**，它只依赖编辑器自身渲染引擎 - 若坚持用外部工具，需手动绑定命令：在
keybindings.json中添加{ "key": "ctrl+shift+d", "command": "workbench.action.terminal.sendSequence", "args": { "text": "git difftool$(sep)"} }，并确保终端能识别git difftool - Windows 用户注意：WSL 环境下配置的
meld路径（如/usr/bin/meld）对 Windows 原生 VSCode 不可见，必须使用 Windows 版 meld 并配置完整可执行路径（如C:\Program Files\Meld\meld.exe）
大文件（>50MB）diff 卡死或直接跳过
VSCode 默认限制单文件 diff 大小为 50MB，超过即静默放弃渲染，不报错也不提示，表现为「对比窗口空白」或「进度条卡住」。
- 调整阈值：在设置中搜索
diffEditor.maxFileSize，改为100（单位 MB），注意该值过大可能导致内存溢出 - 二进制文件（如
.zip、.pdf）即使小于 50MB 也会被跳过，因为 VSCode 默认对已知二进制后缀禁用文本 diff；可临时在工作区设置中添加"files.binary": ["!*.log"]强制按文本处理 - 真正的大日志或数据文件，建议改用命令行：
git diff --no-index file1.log file2.log | head -n 100，避免编辑器加载整文件
{
"diffEditor.maxFileSize": 100,
"files.binary": ["!*.log", "!*.csv"]
}diff 功能失效时，最常被忽略的是「当前编辑器是否处于 diff 视图」——比如你点了 Compare with Saved，结果却在原编辑器标签页里找高亮，而实际新开的对比标签页被缩在角落或被其他面板遮挡。先看标题栏是否含 file1 ↔ file2 字样，再查是否误关了右侧的「Changes」面板。
