VSCode大型单体项目卡顿主因是默认配置未限制文件监听与TS服务范围；需配置files.watcherExclude、tsconfig.json的include/exclude、禁用Auto Import等扫描型扩展，并统一设置files.exclude与search.exclude。
大型单体项目在 VSCode 中卡顿、智能提示慢、搜索卡死，根本不是硬件问题，而是默认配置对数万文件完全不设防——关掉几个监听开关、锁死语言服务范围、禁用非必要扩展，就能让编辑器从“等它缓过来”变成“所见即所得”。
files.watcherExclude 配置失效的常见写法
很多人的 files.watcherExclude 写了却没效果，核心原因是 glob 模式不合法或路径未覆盖真实结构。
-
files.watcherExclude的键必须以**/开头，例如"**/dist/**"有效，"dist/**"或"dist"无效 - 排除项要覆盖所有构建产物目录：除了
node_modules，还要加dist、build、.next、target、out、coverage - 如果项目含子模块（如 Lerna/Yarn Workspaces），需显式写
"**/packages/*/dist/**"和"**/apps/*/build/**"，否则子包下的构建目录仍被监听 - Linux/macOS 下若看到
ENOSPC或watcher limit reached报错，说明 inotify 句柄已耗尽，此时仅靠配置不够，必须配合禁用扩展
TypeScript 语言服务 CPU 占满的真正原因
打开项目后 CPU 持续 90%+，tsserver 进程吃光资源，往往不是代码太复杂，而是它在疯狂解析你根本不用的路径。
- 默认行为：TS 会递归扫描整个工作区，包括
node_modules里的类型声明、每个package.json的依赖树、甚至docs/或scripts/下的 JS 文件 - 关键修复：在项目根目录
tsconfig.json中强制限定作用域：{ "include": ["src/**/*", "types/**/*"], "exclude": ["node_modules", "dist", "build", "test"] } - 顺手关闭自动导入：
"typescript.preferences.includePackageJsonAutoImports": "off"，避免每次敲import都触发全量依赖分析 - 超大项目可进一步禁用项目级诊断：
"typescript.preferences.disableSuggestions": true，只保留基础跳转能力
哪些扩展必须在单体项目中禁用
不是所有扩展都“无害”，有些插件一启用就启动后台全量扫描，直接拖垮文件监视器。
- 优先禁用带 “watch”、“scan”、“index”、“auto-import” 关键词的扩展：如
Auto Import、Path Intellisense、ESLint（若未配eslint.options.ignorePath） - GitLens 默认开启文件变更监听，建议在
.vscode/settings.json中加："gitlens.advanced.fileWatcher.latency": 1000
，把响应延迟拉高到 1 秒，减少抖动 - Live Server 完全没必要——单体项目通常走本地 dev server（如 Webpack Dev Server、Vite），它只会额外起一个 HTTP 服务并监听全部文件
- 验证方式：打开命令面板 →
Developer: Show Running Extensions，看 CPU/Memory 排名前 3 的扩展，停用后观察tsserver和主进程是否回落
search.exclude 和 files.exclude 不是同一回事
很多人只配了 search.exclude 就以为万事大吉，但 files.exclude 才真正决定文件监视器是否启动——漏配等于白配。
-
files.exclude控制资源管理器显示 + 文件系统监听行为，影响 CPU 和 inotify 句柄；search.exclude仅控制Ctrl+Shift+F搜索范围，不影响性能 - 两者都要配，且路径写法尽量统一用
**/xxx/**，避免search.exclude写成"dist/**"而files.exclude写成"**/dist/**"导致漏匹配 - 额外建议加入：
"**/*.log"、"**/tmp/**"、"**/.cache/**"——这些目录常被脚本生成，但几乎从不手动编辑 - 注意：修改后需重启 VSCode 才生效，热重载不触发 watcher 重建
最易被忽略的一点：所有优化配置必须放在工作区级 .vscode/settings.json，而不是用户全局设置。单体项目结构千差万别，全局一刀切只会让小项目变慢、大项目依旧卡——精准，才是唯一有效的策略。
