VSCode Git卡顿主因是Git扩展后台扫描,关自动刷新、排除.git/objects和.git/lfs监听、压缩日志加载三步可显著改善。

VSCode 内置 Git 操作卡顿,90% 以上是 Git 扩展在后台持续扫描变更导致的,不是网络或仓库本身慢——关掉自动刷新、排除 .git/objects 监听、限制日志加载量,三步就能明显改善。
为什么 git.status 或 Git 视图打开就卡
VSCode 的 Git 扩展默认每 2–3 秒执行一次 git status,并在大型仓库中尝试读取完整 diff、解析所有未提交文件、遍历 .git/objects 和 .git/lfs。这些操作在含数万 commit 或启用 LFS 的仓库里极易阻塞主线程。
-
git.autorefresh设为true(默认)时,即使你没点 Git 标签页,它也在后台轮询 -
.git/objects目录被files.watcherExclude忽略前,VSCode 会为每个 loose object 注册监听器,触发大量 inotify 事件 - Git 日志视图默认加载全部历史,
git.log.template用的是完整格式,单次渲染几百条 commit 就会卡顿
禁用自动刷新 + 手动触发
把“自动”变成“按需”,是最直接有效的减负方式。这不是放弃功能,而是避免无效轮询。
- 在工作区
.vscode/settings.json中添加:"git.autorefresh": false - 保留 Git 视图,但改用右键菜单或命令面板里的
Git: Refresh手动更新状态 - 如果连手动刷新都慢,说明底层 Git 命令本身卡——此时应检查是否启用了
core.fsmonitor或是否在 WSL 中未配置git config --global core.untrackedCache true
精准排除 .git 内部目录监听
files.watcherExclude 对 .git 的排除必须细化到子路径,只写 "**/.git/**": true 不够——VSCode 仍会监听 .git/index 和 .git/HEAD,而真正吃资源的是 .git/objects 和 .git/lfs。
- 在
.vscode/settings.json中加入以下排除项:"**/.git/objects/**": true、"**/.git/lfs/**": true、"**/.git/index": true - 注意:路径必须用双星号
**/,写成.git/objects/**会被忽略,起不到过滤作用 - 修改后需关闭并重新打开工作区,设置才生效;仅重启 VSCode 不行
压缩 Git 日志加载与界面装饰
Git 侧边栏的提交计数、状态栏的分支提示、日志视图的完整信息渲染,都是可关闭的“视觉开销”,对大仓库影响显著。
- 关闭状态栏提交计数:
"git.decorations.enabled": false - 简化日志模板,加快渲染:
"git.log.template": "%h %s"(只显示 short hash + subject) - 如不需要图形化分支关系图,可在 Git 视图右上角点击 ⋯ → “Hide Branch Graph” 临时关闭
真正容易被忽略的是:Git 卡顿往往和 files.watcherExclude 配置不生效强相关——很多人加了 "**/.git/**": true 就以为万事大吉,但 VSCode 依然在监听 .git/index,而这个文件每保存一次就触发一次全量 status 扫描。必须拆解到具体子路径,并确认工作区重载已执行。











