VSCode大规模工程索引需精准控制：search.exclude须置于工作区.settings.json，files.watcherExclude防inotify耗尽，改配置后须重载窗口并清.cache，TS索引需限tsserver内存与include范围。
VSCode 对大规模工程的索引刷新不是“要不要做”，而是“什么时候做、做多少、对谁做”——默认全量监听和自动重建会卡死编辑器，必须用 search.exclude、files.watcherExclude 和工作区级配置协同控制。
search.exclude 必须写在 .vscode/settings.json 里才生效
很多人把 search.exclude 放进用户级 settings.json 或 tsconfig.json，结果改了没用。VSCode 只认工作区根目录下 .vscode/settings.json 中的该配置，且只对当前项目起效。
- 错误做法：在全局设置里加
"search.exclude": {"**/node_modules": true}→ 其他小项目也会被误排除 - 正确做法：每个大型项目根目录下建
.vscode/settings.json，只写本项目需要的排除项 - 注意：
search.exclude不影响文件树显示，只限制 Ctrl+Shift+F 搜索范围；要同时配files.exclude才能减少文件监视压力
files.watcherExclude 防止 inotify 句柄耗尽
Linux/macOS 下，VSCode 默认用 inotify 监听文件变更，但系统默认句柄上限（如 /proc/sys/fs/inotify/max_user_watches）常为 8192，遇到含大量子目录的 node_modules 或生成目录时直接爆掉，表现为索引停滞、保存延迟、CPU 空转。
- 临时验证：运行
cat /proc/sys/fs/inotify/max_user_watches，若 ≤ 16384，大概率已不够用 - 推荐配置项：
"files.watcherExclude": {"**/node_modules/**": true, "**/.git/objects/**": true} - 该配置不依赖系统修改，是 VSCode 层面主动跳过监听，比调大系统值更安全、更可移植
修改排除规则后必须重启窗口或删 .vscode/.search
search.exclude 和 files.exclude 不是热更新的——改完配置不会立刻生效，旧索引仍驻留在内存或磁盘缓存中。
- 最可靠做法：改完
.vscode/settings.json后，执行Developer: Reload Window（Ctrl+Shift+P → 输入 reload） - 如果搜索仍慢，手动删除项目根目录下的
.vscode/.search文件夹（这是 VSCode 存放搜索索引的本地缓存） - 不要依赖“重新打开文件夹”，必须是完整窗口重载，否则 watcher 进程可能复用旧状态
TypeScript 索引刷新受 tsserver.maxMemory 和 include 路径双重约束
TS 语言服务（tsserver）的索引刷新行为和搜索无关，但它会抢 CPU、占内存，导致编辑器假死。它的刷新逻辑取决于两个关键点：
-
typescript.tsserver.maxMemory：默认不限制，容易 OOM；建议设为4096（单位 MB），写在.vscode/settings.json中 -
tsconfig.json中的include字段：如果不显式声明，tsserver 会递归扫描整个工作区（包括node_modules）；应只写"include": ["src/**/*"]，并配合"exclude": ["node_modules", "dist"] - 额外提醒：
typescript.preferences.includePackageJsonAutoImports设为"off"，避免自动导入触发全量依赖解析
真正卡顿的根源往往不是“索引太慢”，而是多个机制（文件监视、搜索索引、tsserver）在同一个工作区里无序竞争资源。隔离配置、按需加载、明确边界——这三件事做扎实了，索引刷新就不再是个定时炸弹，而是一个可控的后台动作。
