VSCode 默认不显示 Git 提交记录，需手动触发；GitLens 非开箱即用，须逐项启用功能才能生效。文件无历史因未被 Git 跟踪或 git.enabled 为 false；GitLens blame 注解需开启三项配置；Compare Commits 前须 git fetch；Commit Graph 卡顿可调 maxDepth 或改用终端命令。
VSCode 默认不自动显示 Git 提交记录，必须手动触发；GitLens 不是开箱即用的“增强版历史面板”，而是需要逐项启用关键功能才能释放全部能力——否则你看到的只是个图标，不是工具。
Git: View File History 为什么点不开？
这不是插件没装好，而是 VSCode 没识别到当前文件属于 Git 仓库。常见表现：右键菜单里没有该选项、命令面板搜不到、状态栏左下角不显示分支名。
- 确认文件已被
git add过（git status能列出它），新建未跟踪的文件永远查不到历史 - 检查 VSCode 设置中
git.enabled是否为true（禁用 Git 扩展后所有相关功能失效） - 如果项目根目录有
.git，但你在子目录打开 VSCode，需在设置里指定git.autoRepositoryDetection为true或手动配置git.repositoryScanMaxDepth - Windows 上路径含中文或空格时，偶尔触发 Git 路径解析失败，可临时改用 WSL 终端验证
git log -n 5 --oneline是否正常
GitLens 的 blame 注解为何不显示？
安装 GitLens 后默认只启用部分功能，行级注解（blame）需显式开启，且依赖多个开关协同生效。
- 必须设为
true的三项核心配置：gitlens.codeLens.enabled（行号旁作者/时间）、gitlens.gbl.annotations.enabled（右侧注解栏）、gitlens.gutterIcons.enabled（行号左侧图标） - 快捷键
Cmd+Alt+H（Mac）或Ctrl+Alt+H（Win/Linux）可一键切换注解显隐，比翻设置更快 - 若某行始终空白，可能是该行在最近提交中被完全重写（如格式化、自动 import 排序），Git 认为“无 blameable line”，此时右键选
GitLens: Blame Line强制重新计算 - 大型 JSON/Markdown 文件会拖慢注解渲染，建议在
gitlens.advanced.excludedFiles中添加**/*.json等模式规避
对比两个任意 commit 怎么操作最稳？
VSCode 原生历史视图不支持 Ctrl+Click 多选后对比，GitLens 的 Compare Commits 是唯一可靠路径，但容易因哈希解析失败而报错。
- 先确保已执行
git fetch，否则远程分支的 commit 哈希无法解析，报fatal: bad revision 'xxx' - 命令面板输入
GitLens: Compare Commits，它会自动列出本地已有 commit，避免手输哈希出错 - 选中 Base 和 Compare 后，差异视图默认只展开变更文件列表；点击具体文件名才加载 diff，避免一次性渲染卡顿
- 若需对比跨分支的 commit（如
main与feature/login），务必在 Compare 前右键对应分支 →Fetch Branch，否则本地缓存缺失
Commit Graph 卡顿或空白怎么办？
提交图谱（Commit Graph）本质是实时渲染整个仓库拓扑，对大项目或 reflog 过长的仓库极易卡死，不是性能问题，是设计限制。
- 默认
gitlens.historyExplorer.advanced.maxDepth为 100，遇到长期未清理的仓库，调高至500或1000才能加载完整历史 - 关闭
gitlens.statusBar.enabled和gitlens.recentChanges.enabled可显著降低后台扫描频率，尤其适合单次深度分析场景 - 若图谱中分支线断裂、合并节点消失，检查是否启用了
gitlens.graph.showMergeCommits—— 它控制菱形节点是否渲染，关掉就只剩直线 - 真正的大仓（>10k commits）建议改用终端
git log --graph --oneline --all --simplify-by-decoration，VSCode 图谱更适合中等规模项目快速导航
GitLens 的深度价值不在“多一个按钮”，而在把 Git 命令变成上下文感知的操作：一行代码悬停即见源头，右键即得对比，侧边栏即连远程。但所有这些都建立在明确启用对应功能的基础上——漏掉任何一个开关，它就只是个好看的图标。
