VSCode卡死、搜索慢、启动挂起的根源是未正确排除大型目录：必须同步配置files.watcherExclude、search.exclude，关闭search.followSymlinks，并调高系统inotify限制，缺一不可。
VSCode 本地缓存卡死、搜索慢、启动挂起，基本就是没正确排除大型项目目录——只配 search.exclude 不够，必须同步关掉监听、禁掉符号链接穿透、调高系统限制，否则文件句柄一爆，索引就永远停在“正在建立索引”。
为什么只改 search.exclude 没用
很多人以为加几行 "**/node_modules": true 就万事大吉，其实 VSCode 有两个独立通道：一个是搜索读取（search.exclude 控），另一个是文件变更监听（files.watcherExclude 控）。前者不扫目录，后者还在疯狂注册 inotify 监听器。Linux/macOS 下默认 max_user_watches 是 8192，一个 node_modules 就能占掉五六千个句柄，直接卡死。
-
search.exclude只影响 Ctrl+Shift+F 和 Ctrl+P 的结果，不影响索引构建 -
files.watcherExclude才真正阻止 VSCode 为这些路径注册监听器 - 两者缺一不可，只配一个等于白配
-
"**/node_modules/**"结尾的/**不可省略；写成"node_modules"或"**/node_modules"都不生效
必须加进 files.watcherExclude 的路径
别只抄 node_modules 和 dist，真实项目里这些才是监听炸弹：
-
"**/node_modules/**"：尤其 monorepo 里嵌套的packages/*/node_modules -
"**/.git/**"：GitLens 等插件会高频扫描，大历史仓库极易拖垮 -
"**/target/**"（Rust/Java）、"**/.next/**"（Next.js）、"**/out/**"（TSoutDir） -
"**/*.log"：单个 200MB 日志文件就能让 watcher 队列卡住数秒 - 建议直接把项目
.gitignore里所有非空行转成files.watcherExclude条目
search.followSymlinks: false 是 monorepo 救命开关
用 yarn link 或 npm link 的项目，符号链接常指向外部 node_modules 或 packages。默认 search.followSymlinks: true 会让 VSCode 顺着链接一路扫进去，瞬间多出几千个文件要读，索引直接卡死。
- 设为
false后，搜索和 Ctrl+P 只停在链接文件本身，不穿透 - 它不影响 Go to Definition 跳转，只管全局搜索和快速打开
- 配合
search.exclude更稳，例如同时配"**/packages/**": true和"search.followSymlinks": false
Linux 用户必须调高 inotify 限制
不改这个，再怎么配都白搭。终端执行：
cat /proc/sys/fs/inotify/max_user_watches
若输出低于 524288，运行：
echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches
- 该值只对当前会话有效；如需永久生效，需写入
/etc/sysctl.conf - Windows/macOS 无此限制，但 NTFS 事件队列或 FSEvents 仍有瓶颈，同样依赖
files.watcherExclude - 改完不用重启系统，VSCode 重启后即生效
真正卡住你的从来不是“项目太大”，而是 VSCode 默认对所有目录照单全收。排除不是选做题，是必选项；而且必须四路并进：配 files.watcherExclude、配 search.exclude、关 search.followSymlinks、调系统限制——漏掉任何一环，索引都可能卡在 99% 不动。
