VSCode 打开大项目卡顿 CPU 占用 100% 如何排查

遇到 VSCode 打开大项目卡顿且 CPU 满载，最优先的动作是通过内置进程查看器锁定高占用组件，而不是盲目关闭功能。

先说结论：卡顿通常源于扩展插件或文件监听失控，排查顺序应为先定位进程、再隔离扩展、最后调整配置。

先定位：使用内置进程查看器确认是扩展宿主还是搜索进程占用。
先做：临时禁用非核心扩展并配置文件监听排除项。
再验证：观察 CPU 回落情况且确保代码提示功能正常。

快速处理思路

VSCode 卡顿排查建议按以下顺序操作，优先使用快捷键提升效率：

使用快捷键 Ctrl+Shift+P (Mac: Cmd+Shift+P) 打开命令面板。
输入 Developer: Show Running Extensions 或通过菜单 帮助 > 打开进程查看器。
识别 CPU 占用最高的进程名，针对性禁用扩展或调整设置。

为什么会这样

VSCode 基于 Electron 架构，主进程、渲染进程和扩展宿主进程是分离的。大项目卡顿通常是因为扩展宿主进程（Extension Host）加载了过多插件，或者文件监听服务（File Watcher）试图监控 node_modules 等大量无关文件。此外，内置搜索工具 ripgrep 在索引大型目录时也会瞬间拉高 CPU。

分步处理

第一步：打开进程查看器

在菜单栏点击“帮助”>“打开进程查看器”，或直接通过命令面板搜索 Developer: Show Running Extensions。这里会列出所有子进程的 CPU 和内存占用。找到占用最高的项，记下进程名称，例如 Extension Host、rg.exe 或 vscode-css-language-server。

第二步：排查扩展插件

如果是 Extension Host 占用高，点击“帮助”>“启动扩展 bisect 模式”，或在命令面板输入 Developer: Start Extension Bisect。这会禁用所有非官方扩展，让你判断是否是第三方插件导致。如果卡顿消失，逐个启用插件定位罪魁祸首。

第三步：配置文件排除

打开设置（JSON 模式），添加或修改以下配置，避免监听不必要的文件夹：

"files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/node_modules/**": true,
    "**/dist/**": true,
    "**/.next/**": true,
    "**/.output/**": true
},
"search.exclude": {
    "**/node_modules": true,
    "**/bower_components": true,
    "**/dist": true
}

常见高占用扩展类型

根据工程经验，以下几类扩展容易在大项目中引发 CPU 飙升：

代码检查类：如 ESLint、Stylelint，若未配置 lint.run 为 onSave，会实时扫描全量文件。
实时预览类：如 Live Server，监听文件变化频繁时占用较高。
重型语言服务：如 Java Extension Pack、C/C++，在索引未完成前会持续占用。

怎么验证是否生效

再次打开进程查看器，确认之前高占用的进程 CPU 百分比已明显下降（通常应回落至 5% 以下）。同时在编辑器中尝试快速输入代码，观察智能提示是否有延迟。如果进程查看器中 CPU 占用稳定在低位且界面响应流畅，说明优化生效。

常见坑

1. 不要全局禁用文件监听，否则保存文件后可能不会自动刷新。

2. 远程开发场景下，进程占用可能发生在远程服务端，本地进程查看器可能看不到详细数据。

3. 某些语言服务器（如 TypeScript）在首次打开大项目时会建立索引，此时短暂高占用是正常的，无需过度优化。