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 线程。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 在用户设置（
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，四者叠加会在每次保存时触发多次解析与重写。这时候删掉一行配置，比换电脑管用。
