gitlens 易与其他 git 插件冲突，因其默认抢占行内注释、codelens、状态栏等共享 api 资源；应通过禁用冗余功能、重映射快捷键、隔离视图面板实现协同共存。
GitLens 和其他 Git 插件（比如 Git History、Git Graph、Git Project Manager）同时启用时，大概率会出问题——不是注释重叠、就是命令失效、状态栏 Git 信息闪烁消失。这不是你配置错了，而是它们在抢同一块地盘：编辑器行内注释、CodeLens、侧边栏视图、命令注册表、甚至状态栏贡献点。
为什么 GitLens 容易和其他插件打架
GitLens 的设计目标是“全栈增强”，它默认就往编辑器里塞 blame 行注释、CodeLens 提交链接、状态栏显示当前分支/提交哈希——这些正是其他 Git 插件也想干的事。VS Code 不提供“插件功能分区”机制，所有扩展共享同一套 API 接口，谁后加载、谁配置更激进，谁就容易覆盖别人。
典型表现包括：
-
GitLens: Toggle Line Blame和Git History: Show File History快捷键撞车（都默认用Alt+H） - 文件打开后，同一行出现两套作者信息（GitLens + Git History 的 inline blame）
- 执行
Git: Pull后，状态栏 Git 分支名突然变灰或消失几秒 - 命令面板里搜 “Git” 出一堆重复命令，点哪个都不确定是哪个插件响应的
禁用冲突插件不如隔离功能边界
直接禁用其他 Git 插件太粗暴——比如 Git Graph 的图谱视图、Git Project Manager 的多仓库切换，GitLens 并不提供等效替代。更务实的做法是让每个插件只干自己最擅长的一件事：
- 把
gitlens.currentLine.enabled设为"editorHasSelection"：只在你选中某行时才显示 blame，避免全局污染 - 关闭
gitlens.codeLens.enabled（设为false），把 CodeLens 交给 Git Graph 或原生 Git 扩展处理 - 禁用
gitlens.views.repositories.enabled，用 Git Project Manager 管理多仓库，GitLens 只专注单仓库深度操作 - 在
.vscode/settings.json中加这一条："gitlens.hovers.enabled": "cursor"，让 hover 提示只在悬停时触发，不常驻干扰
快捷键和命令面板必须手动重映射
VS Code 不会自动帮你避让快捷键，GitLens 默认绑的 Alt+B、Alt+H、Alt+Q 是高频冲突源。别指望“改一个就好”，得系统性重定向：
- 打开命令面板（
Ctrl+Shift+P），搜Preferences: Open Keyboard Shortcuts (JSON) - 添加如下覆盖规则（注意 keybinding 冲突时以最后定义为准）：
{
"key": "alt+g b",
"command": "gitlens.toggleLineBlame",
"when": "editorTextFocus && !editorReadonly"
},
{
"key": "alt+g h",
"command": "gitlens.showFileHistory",
"when": "editorTextFocus"
}
同时，在其他 Git 插件设置里，把它们的同类快捷键明确清空（留空或设为 null），否则 VS Code 会按加载顺序随机响应。
视图面板物理隔离比逻辑开关更可靠
GitLens 的 Commits、File History 视图，和 Git Graph 的图谱、Git History 的日志列表，本质都是“历史数据展示”，但渲染方式和交互逻辑不同。强行关掉一个视图不如把它们分开放：
- 右键点击 GitLens 侧边栏标签 →
Move View to Secondary Sidebar - 再右键 Git Graph 标签 →
Move View to Primary Sidebar - 这样两个视图互不抢占空间，也不会因折叠/展开互相触发重绘 bug
- 如果某个视图总在启动时自动弹出，检查
gitlens.views.*.enabled对应项是否为true，关掉它（如gitlens.views.fileHistory.enabled）
真正难搞的从来不是“怎么开”，而是“怎么让多个插件安静地各干各的”。GitLens 的配置项极多，但关键就那三四条——currentLine.enabled、codeLens.enabled、hovers.enabled、views.*.enabled。改完记得重启 VS Code，缓存不清理，旧行为可能还在后台偷偷运行。
