vscode 查看 git 历史差异的核心是选对对比基准：用 git: compare with revision 输入 commit hash/tag/分支名，确保左侧为历史版本、右侧为当前工作区；点击提交后需手动切至 diff 标签；对比两历史 commit 时须在 files 列表中手动点击目标文件；gitlens 的 show line history 可追溯单行变更。
VSCode 查看 Git 历史提交差异，核心不是“找按钮”，而是选对对比基准——用 Git: Compare with Revision 直接输 commit hash 或 tag，比点来点去更稳、更准、不丢上下文。
怎么快速对比当前文件和任意历史 commit
别依赖右键菜单里名字相近的选项（比如 Compare with HEAD 和 Compare with Working Tree），它们默认基准不同，点错就白忙。最可控的方式是：
- 光标停在已打开的文件里，按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac） - 输入
Git: Compare with Revision，回车 - 在弹出的输入框里直接输 commit hash（如
abc1234）、分支名（如main）、tag（如v2.1.0）或相对引用（如HEAD~3）
这个命令强制指定左侧为历史版本，右侧为当前工作区，不会受暂存区状态干扰。如果输错格式，VSCode 会提示 “No commit found”，而不是卡在 Loading —— 这是它在告诉你：Git 根本没识别到那个 revision。
为什么点开某次提交后 Diff 是空的或只显示文件名
VSCode 默认打开的是提交的 Overview 标签页，不是 Diff。很多人以为“点了就是看了”，其实只是看到了元信息。
- 点击某次提交后，务必手动切换到右侧面板顶部的
Diff标签（不是Files或Overview） - 如果
Diff标签灰色不可点，说明该提交中涉及的文件是二进制（如图片、.pdf）、被.gitattributes忽略，或当前工作区根目录 ≠ Git 仓库根目录（常见于符号链接打开项目） - 大文件（>50MB）或含非 ASCII 路径时，VSCode 会静默跳过 diff 渲染 —— 这是硬限制，改设置无效
对比两个历史 commit 之间的单个文件，UI 操作容易漏关键步骤
多选 commit 后右键 Compare Commits 看起来方便，但有个致命盲区：它默认对比的是「两个 commit 的全部变更文件列表」，不是你关心的那个具体文件。
- 正确路径是：先在
COMMITS区域找到第一个 commit → 右键 →Compare with Branch or Tag→ 输入第二个 commit 的 hash 或分支名 - 或者更稳妥：在 COMMITS 列表中
Ctrl+点击两个 commit → 右键 →Compare Commits→ 然后在右侧Files列表中**手动点击目标文件名**，才能看到它的行级差异 - 如果该文件在某个 commit 中被重命名或移动，VSCode 不会自动关联，只会显示
Binary files differ或整块红绿闪烁 —— 此时必须切终端，用git log --follow -p -- path/to/file.ts辅助定位
GitLens 的 Show Line History 不是万能，但能补原生功能的短板
原生 VSCode 只能告诉你“这个文件在哪几次提交里动过”，没法回答“这一行代码是谁、什么时候、为什么改的”。这时候得靠 GitLens：
- 光标停在目标行，
Ctrl+Shift+P→ 输入GitLens: Show Line History，回车 - 它列出的是该行参与过的所有提交（不是文件的全部提交），按时间倒序，每条都带作者、时间、message
- 注意：
GitLens: Show Line History对未git add的本地修改不生效；如果该行在某次提交中被删又重建，两次会作为独立条目出现，但中间空白期不可见 - 想深挖某次提交里这行的原始值？选中该行 → 右键 →
GitLens: Compare Line with Previous Revision，不是直接点提交记录
真正容易被忽略的是：diff 视图左侧永远是“基准版本”，右侧才是“你的修改”。很多人盯着右边改逻辑，却没确认左边是不是自己心里认定的那个“稳定版” —— 尤其当基准是 HEAD~5 或某个 feature 分支时，差一个 commit，语义可能完全相反。
