VS Code 处理大型项目卡顿的核心是按需加载而非简单禁用：需限制扩展作用范围、精准配置 files.exclude 和 search.exclude 排除 node_modules 等目录、在 tsconfig.json 中显式声明 include 路径并关闭 TS 自动导入、对大目录使用符号链接隔离。
VS Code 处理大型项目卡顿，核心不是“关掉什么”，而是“让哪些东西只在需要时才加载”——默认配置对 10 万行以上项目或含 node_modules 的仓库极不友好，必须主动干预。
禁用非必要扩展和启用工作区级扩展
大量扩展（尤其 ESLint、Prettier、GitLens、TypeScript 插件）会在后台持续扫描整个工作区，遇到 node_modules 或 dist 目录时 CPU 和内存飙升。关键不是删扩展，而是控制作用范围：
- 打开命令面板（
Ctrl+Shift+P），运行Extensions: Show Enabled Extensions，逐个检查是否真正在当前项目中被使用 - 右键禁用的扩展 → “在工作区中禁用”，避免影响其他小项目
- 特别注意：禁用
Auto Import、Path Intellisense、Bracket Pair Colorizer等常驻解析型扩展；保留ESLint但确保其eslint.options中设置了"ignorePath": ".eslintignore"，否则会遍历所有子目录
精准配置 files.exclude 和 search.exclude
VS Code 的文件监视器（file watcher）默认监听整个文件夹，哪怕你只是想看一个 src 子目录。一旦包含 node_modules、build、.git，inotify 句柄耗尽、搜索变慢、保存延迟就会立刻出现：
- 在工作区
.vscode/settings.json中写死排除项，而非用户全局设置（避免误伤其他项目）：
{
"files.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/.git": true,
"**/coverage": true
},
"search.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/coverage": true
}
}
注意：files.exclude 影响资源管理器显示和文件监视，search.exclude 仅影响 Ctrl+Shift+F 搜索范围，两者都要设，且路径需用双星号 **/ 才能递归生效。
关闭 TypeScript 自动类型获取（tsserver）的全量扫描
TypeScript 语言服务在大型项目中默认尝试索引全部依赖，导致首次打开后数分钟内无响应、CPU 占满。这不是 VS Code 的问题，而是 tsserver 的默认行为：
- 在工作区
tsconfig.json中添加"include"显式声明要处理的路径，例如：
{
"include": ["src/**/*", "types/**/*"],
"exclude": ["node_modules", "dist", "build"]
}
- 同时在
.vscode/settings.json加上：
{
"typescript.preferences.includePackageJsonAutoImports": "off",
"typescript.preferences.useAliasesForBuiltinTypes": false,
"typescript.suggest.autoImports": false
}
这些选项能显著减少 tsserver 启动时的包解析压力。如果项目本身用 Vite 或 Webpack 构建，甚至可考虑关闭 TS 插件，改用终端 tsc --noEmit 手动校验。
用符号链接隔离大体积依赖或生成目录
有些项目结构无法避免大目录（如嵌入的 SDK、文档静态站、日志输出），files.exclude 只是隐藏，不解除监视。真正解耦的方式是移出工作区并用符号链接接入：
- 把
docs/_site移到项目外（如~/projects/myapp-docs/_site） - 在原位置创建软链：
ln -s ~/projects/myapp-docs/_site docs/_site（macOS/Linux）或mklink /D docs\_site C:\users\me\projects\myapp-docs\_site（Windows） - VS Code 默认不监视符号链接目标，既保功能又避负担
这个技巧对 CI 输出物、第三方二进制依赖、历史数据快照等场景特别有效——它们本就不该参与编辑流程。
真正卡顿往往来自多个小配置叠加失效：比如 search.exclude 漏了一项 **/logs，而某脚本每秒写一个新日志文件，就会持续触发文件系统事件。调优不是一劳永逸，而是每次新增大目录时，都得同步更新 files.exclude 和 search.exclude。
