gitlens卡顿典型表现为光标延迟、切换文件卡顿、分支视图加载慢或extension host内存长期＞500mb；确认方式是执行developer: open process explorer，查看eamodio.gitlens子进程rss是否持续超400mb。
GitLens 卡顿的典型表现和确认方式
GitLens 启用后出现光标延迟、切换文件卡顿、分支视图加载慢，或 Extension Host 进程内存长期 > 500MB，基本可锁定为它导致。别靠经验猜——按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并执行 Developer: Open Process Explorer，直接看 Extension Host 下子项的 Memory 列。若 eamodio.gitlens 对应进程 RSS 持续超 400MB，就是它。
禁用 GitLens 高耗功能比完全卸载更有效
GitLens 默认开启大量后台监听，尤其是 gitlens.lineAnnotations.enabled（行级 blame）、gitlens.codeLens.enabled（代码引用统计）和 gitlens.advanced.caching.enabled（全仓库缓存），这些在中大型项目里会持续扫描提交历史和文件树，CPU 和内存双吃紧。
- 在工作区
.vscode/settings.json中添加以下配置（优先写工作区而非全局）：
{
"gitlens.lineAnnotations.enabled": false,
"gitlens.codeLens.enabled": false,
"gitlens.advanced.caching.enabled": false,
"gitlens.gitCommandTimeout": 3000
}
注意：gitlens.gitCommandTimeout 设低些能防止 git 命令卡死拖住整个 Extension Host；禁用后必须关闭当前 VS Code 窗口再重新打开，否则旧进程仍驻留。
files.watcherExclude 必须配合 GitLens 使用
GitLens 的性能问题常被误认为“插件本身慢”，其实是它依赖的底层文件变更通知被 node_modules、.git 等目录拖垮。VS Code 默认为每个文件注册 inotify 监听器，一旦 GitLens 开始分析 Git 状态，就会触发海量路径遍历 —— 而 files.watcherExclude 是唯一能从源头掐断它的配置。
- 必须在项目根目录的
.vscode/settings.json中设置（全局设置无效）： "**/node_modules/**": true"**/.git/**": true"**/dist/**": true"**/build/**": true- Linux 用户务必检查：
cat /proc/sys/fs/inotify/max_user_watches，若低于524288，运行echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches
漏掉 .git 这一项，GitLens 就会反复读取 .git/objects 下成千上万个松散对象，内存占用翻倍是常态。
GitLens 缓存失控是隐藏内存泄漏源
旧版 GitLens（v14.x 及之前）默认缓存不设上限，且过期时间长达 1 小时。在提交历史超 10 万条的仓库里，缓存 Map 会持续增长，GC 无法回收，最终导致 Extension Host 内存只增不减。
- 升级到 v15.0+ 后，启用 LRU 缓存淘汰（自动生效），但仍建议手动限制：
- 在设置中加入：
"gitlens.advanced.cacheSize": 500（单位：MB） - 若已发现内存异常，先清理缓存：
rm -rf ~/.vscode/extensions/eamodio.gitlens-*（macOS/Linux）或%USERPROFILE%\.vscode\extensions\eamodio.gitlens-*（Windows） - 重启 VS Code 后，观察
Developer: Open Process Explorer中内存是否回落至 150–250MB 区间
缓存配置不生效的常见原因是写在了用户设置里，而 GitLens 的缓存策略只响应工作区设置 —— 这一点极容易被忽略。
