VSCode卡顿优先用Developer: Reload Window重启渲染进程;再用Developer: Show Running Extensions定位高CPU扩展;工作区需配置files.watcherExclude排除node_modules等目录。

VSCode 启动慢、打字卡顿,先别重装,试试 Developer: Reload Window
多数卡顿不是缓存爆炸导致的,而是扩展进程泄漏或渲染层僵死。强制重载窗口比清缓存更快见效,且不丢当前文件和编辑状态。
操作方式:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Developer: Reload Window 回车即可。这相当于重启 VSCode 的渲染进程,但保留所有打开的标签页和光标位置。
- 适合场景:打字延迟、自动补全失灵、右键菜单响应慢、折叠箭头点击无反应
- 注意:它不会关闭调试会话或终端,但正在运行的
npm run dev等前台终端进程可能被中断(后台终端通常保留) - 别和
Developer: Toggle Developer Tools混淆——后者只开控制台,不解决卡顿
真要清缓存?别删整个 Cache 文件夹,只动这三个目录
VSCode 缓存分散在不同位置,盲目删除 Cache 可能导致扩展配置错乱或登录态丢失。真正影响性能的是以下三个目录:
-
~/.vscode/extensions/下的扩展临时文件:某些扩展(如ms-python.python)会在自己子目录里建cache/或__pycache__/,可手动进对应文件夹删 -
~/Library/Caches/com.microsoft.VSCode.ShipIt/(macOS)或%LOCALAPPDATA%\Programs\Microsoft VS Code\Cache\(Windows):存放自动更新临时包,积压多时会拖慢启动,删掉无害 -
~/.vscode-insiders/(如果装了 Insiders 版):和稳定版缓存隔离,容易被忽略,但同样会累积
不建议碰 UserData/ 和 GlobalStorage/ —— 这里存着你的设置、Snippets、已信任工作区等,误删等于重置全部偏好。
扩展是最大卡顿源,用 Developer: Show Running Extensions 定位真凶
很多用户以为关掉几个“看起来重”的扩展就行,其实更隐蔽的问题是某个扩展持续占用主线程。VSCode 自带诊断命令能直接列出 CPU 占用排名。
执行 Ctrl+Shift+P → 输入 Developer: Show Running Extensions,会弹出表格,重点关注 Host 列为 Renderer 且 CPU 长期 >20% 的扩展。
- 典型高危扩展:
esbenp.prettier-vscode(大文件格式化时阻塞 UI)、ms-python.vscode-pylance(项目未配置pyrightconfig.json时全量扫描)、eamodio.gitlens(开启gitlens.advanced.legacyGitSupport后解析慢) - 验证方法:禁用可疑扩展 →
Developer: Reload Window→ 对比打字/滚动流畅度 - 不要用“禁用全部再逐个开”的方式——有些扩展依赖其他扩展激活,顺序错会导致功能异常
工作区过大时,.vscode/settings.json 里的 files.watcherExclude 必须配
VSCode 默认用文件系统监听器追踪变更,一旦工作区含 node_modules、dist/、build/ 等目录,监听器就会陷入递归陷阱,CPU 持续飙高。
在当前项目根目录的 .vscode/settings.json 中加这一段:
{
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/.git/**": true
}
}
注意:files.watcherExclude 是全局设置,但写在工作区级 settings.json 里才对当前项目生效;写在用户级设置里会影响所有项目,反而可能误伤需要监听的子模块。
这个配置不会让 VSCode “看不见”这些文件,只是跳过监听——搜索(Ctrl+Shift+F)、跳转定义等功能照常,但保存文件后不再卡顿等待监听器扫完十万个小文件。
真正难处理的是混合型项目:比如前端工程里嵌了 Python 脚本,又用了 Lerna 管理多包。这种情况下,单靠排除不够,得配合 search.exclude 和语言服务器的独立配置来分层压制。


















