VSCode全局搜索卡死主因是未同步配置search.exclude和files.watcherExclude：前者跳过搜索时读取，后者在启动时切断监听源头；二者缺一不可，且必须用"/node_modules/"等正确glob写法，并重载窗口生效。
VSCode全局搜索卡死，不是编辑器坏了，而是它正在 node_modules 里逐个打开几千个 .js 文件——而且很可能还顺手解码了中文注释和 GBK 编码的日志。必须同时改两个配置，否则只配 search.exclude 是白忙。
为什么只配 search.exclude 还是卡？
search.exclude 只控制“搜的时候跳过哪些路径”，但卡死往往发生在你还没点 Ctrl+Shift+F 的时候：文件监视器（watcher）已经把 node_modules、.git、dist 全注册进 inotify 队列，持续吃 CPU 和内存句柄。等你真开始搜索，主线程早被压得喘不过气。
-
search.exclude生效于搜索阶段，不读文件内容 -
files.watcherExclude生效于工作区加载阶段，直接阻止监听注册 - 二者缺一不可；只配前者，watcher 仍在后台疯狂扫描
- 写错 glob 模式（比如漏掉结尾
/**）会导致规则完全失效
search.exclude 和 files.watcherExclude 怎么写才对？
必须用标准 glob 写法，且路径要一致。以下是在项目根目录 .vscode/settings.json 中的推荐配置：
{
"search.exclude": {
"**/node_modules/**": true,
"**/.git/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/out/**": true,
"**/target/**": true,
"**/.next/**": true,
"**/*.log": true,
"**/*.zip": true,
"**/*.pdf": true,
"**/public/**/*.{png,jpg,gif,svg}": true,
"**/locales/**": true,
"**/README*": true,
"**/CHANGELOG*": true
},
"files.watcherExclude": {
"**/node_modules/**": true,
"**/.git/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/out/**": true,
"**/target/**": true,
"**/.next/**": true,
"**/*.log": true,
"**/*.gz": true,
"**/*.zip": true
}
}
-
**/node_modules/**结尾的/**不能省——写成"**/node_modules"或"node_modules"都不生效 - 中文项目要额外加
"**/locales/**"和"**/README*"，避免扫几百 KB 的中文文档 -
**/*.gz必须加：watcher 会尝试探测压缩包内容，单个大日志压缩包就能阻塞队列 - 修改后需重载窗口（Ctrl+Shift+P → Developer: Reload Window），配置才真正生效
远程开发（Remote-SSH）下卡死怎么破？
Remote-SSH 卡死，90% 是因为远程服务器上的 searchService 和 tsserver 进程没设内存上限，遇到中文路径或嵌套 node_modules 直接吃光 4GB 内存。本地加 --max-old-space-size 完全无效。
- 必须在 VSCode 设置中配置
remote.SSH.remoteServerEnv - 加上
VSCODE_NODE_OPTIONS: "--max-old-space-size=4096" - 同时确保远程服务器的 inotify 限制足够：
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p - 如果远程项目用了
yarn link或npm link，务必设"search.followSymlinks": false，否则 watcher 会顺着链接一路扫进外部仓库
容易被忽略的硬伤：大文件和编码探测
VSCode 默认对非 UTF-8 文件（如 GBK 日志）会反复尝试解码，单文件解析可能耗时 200ms+。而 search.maxFileSize 默认是 12MB，意味着一个 10MB 的 app.log 就能拖慢整轮搜索。
- 加配置
"search.maxFileSize": 2（单位 MB），直接跳过所有 >2MB 的文件 - 中文项目若混有 GBK 文件，建议统一转 UTF-8，或在对应目录加
"**/logs/**"到 exclude 列表 -
search.useIgnoreFiles默认为true，但如果项目没.gitignore，它就不干活；别依赖它代替显式 exclude - 符号链接穿透比想象中更危险：一个
packages/utils软链指向外部 monorepo，可能瞬间多出上万个文件
真正起效的关键不在“加了多少条排除规则”，而在是否让 watcher 彻底放弃监听、是否切断大文件解码路径、以及远程环境下有没有管住远端 Node 进程的内存。改完配置不重载窗口，等于没改。
