必须用 search.exclude 配置到 settings.json 才生效;files.exclude 不影响全局搜索;正确写法需以 / 或 / 开头的 glob 模式,如 "/node_modules": true;还需同步配置 files.watcherExclude 以避免监视器拖慢搜索。

必须用 search.exclude 配置,写进 settings.json 才真正生效;files.exclude 完全不影响 Ctrl+Shift+F 搜索。
为什么 node_modules 还是被搜到了
常见错误不是配置漏了,而是路径写法或配置位置不对:
-
"node_modules": true无效——缺少 glob 前缀,VSCode 不识别 -
"node_modules/**": true也无效——开头没**/或/,直接被忽略 - 把规则加到
files.exclude里,只隐藏侧边栏,对搜索零影响 - 多根工作区下,只在根目录
.vscode/settings.json写一条规则,无法覆盖所有子文件夹
search.exclude 的正确写法和路径语义
路径必须是 glob 模式,且以 **/ 或 / 开头;不支持正则,也不接受绝对路径:
-
"**/node_modules": true→ 排除所有层级下的node_modules(推荐) -
"/node_modules": true→ 只排除工作区根目录下的node_modules(适合单层结构) -
"**/dist/**": true→ 排除dist及其全部子内容(结尾/**合法但冗余) -
"**/*.log": true→ 排除所有.log文件
files.watcherExclude 必须同步配,否则搜索还是慢
很多人配完 search.exclude 发现搜索准备阶段依然卡顿,是因为文件监视器(file watcher)还在后台扫描那些大目录——即使不搜,它也在反复 stat 和 inotify,CPU 占用高,拖慢整个流程。
- 必须补上
files.watcherExclude,路径和search.exclude保持一致 -
files.watcherExclude不支持字符串值,别写成"true",否则无效 - 正确写法:
"files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true }
临时排除比永久配置更灵活?
搜索面板右下角的 files to exclude 输入框,支持本次搜索临时加规则,优先级高于 search.exclude,但不保存、不跨会话:
- 输入
**/src/test/**,这次搜索就跳过测试目录,关掉面板就失效 - 适合调试时快速过滤,比如确认某段代码是否只在
legacy目录里出现 - 填的仍是 glob 模式,不能用
~或$HOME这类变量 - 如果同时在
settings.json和这个输入框设了冲突规则,以输入框为准
真正起效的关键不在“写了多少条规则”,而在于 search.exclude 和 files.watcherExclude 是否严格同步、路径前缀是否合规、以及多根工作区下是否为每个子文件夹单独配了 .vscode/settings.json。漏掉任意一点,都可能让搜索变慢或结果不准。


















