VS Code卡顿主因是扩展、设置或工作区配置失控;禁用GitLens等高负载扩展、配置files.watcherExclude、优化TS语言服务、限制工作区范围可显著改善。

VS Code 卡顿,通常不是硬件问题,而是扩展、设置或工作区配置失控导致的——关掉几个扩展,往往比升级内存更有效。
禁用可疑扩展:从 GitLens、ESLint、Prettier 开始排查
这些扩展功能强,但默认开启全项目监听,尤其在大型仓库中会持续扫描文件、触发格式化或语法检查,CPU 占用飙升。真实案例中,禁用 GitLens 后编辑器响应延迟从 800ms 降到 40ms。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Extensions: Show Enabled Extensions查看已启用列表 - 逐个禁用高风险扩展:
GitLens、ESLint、Prettier、Auto Rename Tag、Path Intellisense - 每次禁用后重启 VS Code,用
Ctrl+Shift+P→Developer: Toggle Developer Tools观察 Performance 标签页的主线程活动 - 若某扩展禁用后卡顿消失,不要直接卸载,先查其设置:比如
GitLens可设"gitlens.advanced.caching.enabled": false或限制作用范围
关闭不必要的文件监视:重点调 files.watcherExclude 和 search.followSymlinks
VS Code 默认用底层文件系统监听(如 chokidar)追踪变化,一旦项目含 node_modules、dist、.git 或大量构建产物,监听器会频繁触发并阻塞 UI 线程。
- 在用户设置(
settings.json)中添加:
{
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/.git/**": true,
"**/coverage/**": true
},
"search.followSymlinks": false
}
files.watcherExclude 是硬性过滤,比 files.exclude 更早生效;注意路径通配符必须用双星号 **,单星号无效search.followSymlinks 设为 false 可避免搜索时遍历符号链接目录(常见于 monorepo 的 packages 链接)"files.useExperimentalFileWatcher": true(仅限 VS Code 1.85+),启用基于 inotify/fsevents 的轻量监听器限制 TypeScript/JavaScript 语言服务负载:调整 typescript.preferences.includePackageJsonAutoImports
TypeScript 语言服务器(TSServer)是后台最常“拖慢”VS Code 的进程之一,尤其在含多个 tsconfig.json 或大量依赖的项目中。它默认自动索引所有 node_modules/@types,极易引发内存溢出与响应延迟。
- 在工作区设置中加入:
{
"typescript.preferences.includePackageJsonAutoImports": "auto",
"typescript.preferences.suggestAutoImports": false,
"typescript.preferences.useAliasesForBuiltinTypes": false
}
"auto" 表示只在显式 import 时才补全,而非全局预加载;设为 "off" 更激进,但可能影响开发体验pnpm 或 yarn pnp,务必确认 typescript.tsdk 指向工作区本地安装的 TS 版本,否则会 fallback 到 VS Code 内置旧版,兼容性差且更卡TypeScript: Restart TS Server 立即生效,无需重启编辑器避免工作区过大:不用单个窗口打开整个 monorepo 根目录
VS Code 不是 IDE,它本质是“多文件编辑器 + 插件生态”。把包含 20+ 子包、数万文件的 monorepo 根目录直接作为工作区打开,等于让所有扩展和语言服务同时处理全部内容,必然卡顿。
- 改用
File → Add Folder to Workspace…,只添加当前正在开发的子包目录(如packages/api) - 配合
workbench.editor.enablePreview设为false,防止单击文件时反复覆盖标签页,减少 DOM 渲染压力 - 若需跨包跳转,用
Ctrl+Click(或Cmd+Click)直接跳转定义,不依赖全局索引——前提是已正确配置paths和baseUrl在tsconfig.json中 - 对纯前端项目,禁用
npm扩展(它会扫描整个node_modules生成依赖图谱),改用终端手动运行npm ls
真正难调的卡顿,往往藏在“看起来无害”的组合里:比如 ESLint + Prettier + Format on Save + 大型 prettier.config.js,四者叠加会在每次保存时触发多次解析与重写。这时候删掉一行配置,比换电脑管用。











