git: view history 打不开需满足三条件：项目根目录有.git、git.enabled为true、焦点在仓库根目录；点提交后需手动点diff标签看改动；查单文件历史用view file history；对比任意commit需分步compare with revision。
Git: View History 打不开？先确认三个硬性条件
VSCode 内置的 Git: View History 命令根本不会响应，不是插件问题，而是基础环境没达标。它对项目结构和配置极其敏感：
- 当前打开的文件夹下必须存在
.git目录（git init未执行、路径选错、或用符号链接打开项目都会失败） -
git.enabled设置必须为true（在 VSCode 设置里搜这个配置项，禁用状态会导致所有 Git 功能静默失效） - 多根工作区（multi-root workspace）中，焦点必须落在 Git 仓库根目录内——VSCode 只对“活动的”那个仓库提供 Git 入口
满足这三点后，Ctrl+Shift+P 输入 Git: View History 才会弹出图形化拓扑图。刚初始化的单分支仓库看起来像文字列表，是正常表现，不是卡顿或故障。
点开提交却看不到代码改动？别漏掉 Diff 标签
点击某次提交后，默认只显示作者、时间、message 和 Files 列表，VSCode 不会自动跳转到差异视图。这是最常被误认为“插件坏了”的地方：
- 右侧面板顶部必须手动点击
Diff标签（不是Overview或Files）才能看到具体改了哪几行 -
Diff标签灰色不可点？说明该文件在那次提交中是二进制（如图片）、被.gitattributes忽略，或当前工作区根目录 ≠ 仓库根目录（比如你在子目录打开 VSCode，但.git在父目录） - 换行符配置异常（如
core.autocrlf=true）会导致 diff 渲染出大量虚假变更，临时把 VSCode 设置里files.eol改为\n可验证是否为此问题
想查某个文件的完整修改轨迹？用 View File History，不是 View History
Git: View History 是看整个仓库的，Git: View File History 才是追踪单个文件的——包括重命名、移动后的全部提交：
- 必须在编辑器中已打开该文件，且该文件已被
git add过（git status能列出它） - 右键菜单里的
Git: View File History有时不出现，不是插件问题，而是 VSCode 没识别到当前文件属于 Git 仓库（检查左下角状态栏是否显示分支名） - 刚新建但没
git add的文件，历史为空是正常的，不是功能失效
对比两个任意 commit？VSCode 不支持多选，得绕一下
Git: View History 和 Git: View File History 都只支持单提交上下文浏览，没有“Ctrl+Click 选 A 和 B → 对比”这种交互逻辑：
- 最快方式：先用历史视图复制第一个 commit 的哈希（如
abc1234），再执行Git: Compare with Revision粘贴；然后右键当前编辑器 →Compare with Revision粘贴第二个哈希（如def5678） - 跨分支对比前，务必先运行
git fetch origin，否则哈希解析失败会报fatal: bad revision 'xxx' - 对比大文件（>50MB）时，VSCode 内置 diff 易卡顿，直接终端执行
git diff abc1234 def5678 -- path/to/file更稳
图形视图依赖 reflog 构建结构，如果 .git/logs/refs/heads/ 膨胀到几 MB，渲染就会明显变慢甚至白屏——这不是插件问题，是 Git 本地元数据积累导致的底层瓶颈。
