必须点击“staged changes”区域才能查看暂存区差异，因其默认折叠且需手动展开；文件须先执行 git add 才会出现在该区域，且需保存后vscode才能正确对比工作区与暂存区。
点“STAGED CHANGES”区域才能看到暂存区差异
VSCode 的源代码管理（SCM）视图里，“CHANGES”和“STAGED CHANGES”是两个独立区域，不点对地方就看不到暂存区内容。默认只展开“CHANGES”（未暂存），而“STAGED CHANGES”被折叠在下方，需手动下拉或滚动到底部才能看见。
常见错误现象：点了文件却一片空白、没高亮、没 +/- 符号——大概率是因为你点的是“CHANGES”里的文件，而不是“STAGED CHANGES”列表里的同名文件。
- 必须先执行
git add <file></file>，否则文件不会出现在“STAGED CHANGES”中 - 文件修改后务必按
Ctrl+S（或Cmd+S）保存，否则 VSCode 对比的是内存缓存 vs 磁盘，不是工作区 vs 暂存区 - 左下角状态栏没显示分支名（如
main），说明当前路径未识别为 Git 仓库根目录，git status也查不到该文件
用命令面板精准触发暂存区对比
右键菜单和图标点击容易误触，最稳的方式是调出命令面板直接执行对应命令。
Git: Compare Working Tree with Index 是唯一明确指向「工作区 vs 暂存区」的命令，它等价于 git diff --cached。执行后，会自动打开 diff 编辑器：左侧是暂存区（上次 git add 的快照），右侧是当前工作区（你刚改完还没 git add 的内容）。
- 不要混淆
Git: Open Changes——它对比的是工作区 vs HEAD（即上一次提交），不是暂存区 - 如果编辑器已打开目标文件，该命令会直接加载 diff；否则弹出文件选择器，仅列出已暂存的修改文件
- 快捷键
Ctrl+Shift+P输入时建议打全名，部分主题下缩写（如 “compare index”）可能匹配不到
diff 视图里怎么操作才算真正暂存？
在 Git: Compare Working Tree with Index 打开的 diff 编辑器中，左侧灰色块 = 暂存区内容，右侧白色块 = 当前工作区改动。关键操作逻辑是“把右边改的复制到左边”，才算加入暂存区。
- 行号左侧出现
>箭头，点击即可将右侧该行改动“同步到左侧”——效果等同于对该行执行git add -p - 选中某段改动（鼠标拖选或双击某 hunk），右键选
Stage Selected Ranges，只暂存这部分，其余保留为未暂存状态 - 顶部工具栏有
Stage All按钮，但慎用：它会把当前文件所有未暂存改动一次性加入暂存区，不可逆
为什么“STAGED CHANGES”里文件没显示差异？
不是 UI 坏了，而是 Git 状态本身没对齐。VSCode 的暂存区视图依赖 git ls-files --stage 解析索引，任何导致索引读取失败或内容为空的操作都会让该区域变空或显示“No changes”。
- 换行符配置冲突：Windows 上
core.autocrlf=true+ Linux 风格换行（\n）会导致 Git 忽略差异，临时运行git config core.autocrlf false再刷新 SCM 视图 - 文件被格式化插件（如 Prettier）在保存时重写，造成瞬间多次变更，干扰暂存状态检测；可临时关闭
editor.formatOnSave验证 - 多仓库工作区中，VSCode 默认只激活主文件夹的 Git 上下文；右键其他子仓库文件夹 →
Git: Initialize Repository或Git: Refresh Repositories
真正可靠的判断依据永远是终端里跑一句 git diff --cached --name-only —— 如果它有输出，但 VSCode 里没显示，问题一定出在扩展状态同步或路径识别上，不是你改得不对。
