gitlens 的提交历史查看功能默认关闭，需手动启用“内联提交信息”或“文件历史”视图；右键无菜单因默认不注入、相关设置未开启；最稳方式是用命令面板执行 gitlens: show file history。
GitLens 的提交历史查看功能默认是关闭的，必须手动启用“内联提交信息”或打开专用的“文件历史”视图，否则右键菜单里根本不会出现 GitLens: Show File History 选项。
为什么右键没看到 GitLens 的历史菜单？
常见错误现象是安装 GitLens 后直接在编辑器里右键文件标签或侧边栏文件名，却找不到任何 GitLens 相关选项——这通常是因为 GitLens 默认不注入右键菜单项，且“内联 blame”和“文件历史”功能需单独开启。
- 检查设置中
gitlens.codeLens.enabled是否为true（影响行号旁的提交作者/时间显示） - 确认
gitlens.fileHistoryExplorer.enabled已启用，否则资源管理器里不会出现“文件历史”图标 - VSCode 的
context menu权限可能被工作区设置覆盖，检查.vscode/settings.json里是否误禁了gitlens.views.fileHistory.enabled
快速打开当前文件的完整提交历史
最稳的方式不是依赖右键，而是用命令面板直达核心功能。它绕过所有菜单可见性问题，且支持模糊搜索。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
GitLens: Show File History并回车 —— 这会立即加载当前打开文件的全部 commit 列表 - 若当前未打开文件，可先在资源管理器中选中目标文件，再执行该命令
- 历史列表支持点击 commit 查看 diff、右键复制 SHA、点击作者跳转到其提交汇总页
对比两个版本时别漏掉“Compare with Previous Revision”
GitLens 在编辑器右上角提供了一组轻量操作按钮，但“与上一版本比较”按钮（Compare with Previous Revision）常被忽略，它比手动挑 commit 再 diff 更快，尤其适合逐行排查最近一次修改引入的问题。
- 确保编辑器右上角已显示 GitLens 工具栏（由
gitlens.statusBar.enabled控制） - 点击
Compare with Previous Revision按钮，会自动打开 diff 视图，高亮显示本次 commit 修改的所有行 - 该操作不依赖当前光标位置，但只对已提交的变更有效；如果文件有未提交改动，会提示“no previous revision”
- 想对比任意两个 commit？得回到“文件历史”视图，按住
Ctrl（或Cmd）多选两个条目，再右键选Compare Revisions
性能敏感场景下要关掉自动 blame
大型单文件（如生成的 JSON、超长 Markdown 或前端打包产物）会触发 GitLens 持续计算每行的提交信息，导致编辑器卡顿、CPU 占用飙升，此时必须限制范围。
- 禁用全局 blame：
gitlens.codeLens.enabled设为false - 仅对特定语言启用：
"gitlens.codeLens.languages": ["javascript", "python", "go"] - 或直接排除大文件：
"gitlens.advanced.files.ignore": ["**/*.min.js", "**/dist/**", "**/node_modules/**"] - 注意：禁用后
GitLens: Annotate With Blame命令仍可用，只是不再自动显示
真正容易被忽略的是：GitLens 的“文件历史”视图默认只显示当前分支的提交。如果某次修改发生在 feature 分支上、后来才合并进 main，但你在 main 分支打开该文件，历史列表里就看不到那个 feature 提交——得手动切换到原分支，或者用 GitLens: Show All Commits 查全量记录。
