search.exclude 必须用 / 开头的 glob 模式,路径用正斜杠,值为 true;否则静默失效。它仅影响 Ctrl+Shift+F 搜索,与 files.exclude 无关,临时排除优先级更高,修改后需重载窗口刷新索引缓存。

search.exclude 配置必须用 glob,否则静默失效
VSCode 的 search.exclude 不解析普通路径或模糊字符串,只认 glob 模式。写成 "node_modules": true 或 "dist/**": true 都会被直接忽略——不报错、不警告、也不生效。
正确写法必须满足三个条件:
- 以
**/开头(表示“任意层级下的该目录/文件”) - 路径全部用正斜杠
/(Windows 下也不能用\) - 值必须是布尔型
true,不能是字符串"true"
常见错误示例:"*.log": true 只匹配当前目录下的 .log 文件;".log": true 语法非法,整条规则丢弃。应改为 "**/*.log": true。
files.exclude 和 search.exclude 作用范围不同,别混用
files.exclude 控制左侧资源管理器和 Ctrl+P 快速打开的可见性;search.exclude 仅影响 Ctrl+Shift+F 全局搜索。二者都支持 glob,但互不继承。
典型误配场景:
- 只配了
files.exclude却发现搜索仍扫node_modules→ 缺少search.exclude - 在
search.exclude里加了"**/.git": true,但Ctrl+P还能打开 .git/config → 因为files.exclude没同步配
建议:两个配置保持一致,除非你明确需要“能看到但不搜”或“能搜但不显示”这种特殊分离。
临时过滤优先级高于配置,搜出来不该有的文件先看这里
打开搜索面板后,右上角 ⋯ → «Files to exclude» 输入框的内容,会完全覆盖 search.exclude 中的同名规则。这是最常被忽略的调试入口。
使用要点:
- 多个规则用英文逗号分隔,不能有空格:
**/tests/**,**/mocks/**✅,**/tests/**, **/mocks/**❌ - 填错格式(比如漏
**/前缀)会静默失效,搜索结果不变,容易误判为“功能坏了” - 关闭面板后自动清空,适合一次性排查,不用改配置
当你怀疑某次搜索结果异常,第一反应不是重装插件,而是点开这个输入框看看有没有残留内容。
改完 search.exclude 后没变化?重载窗口比重启更可靠
VSCode 搜索依赖本地索引缓存,修改 search.exclude 后不会自动重建索引。尤其在大型项目中,旧结果可能持续出现好几轮搜索。
操作建议:
- 按
Ctrl+Shift+P→ 输入Developer: Reload Window→ 回车 - 比完全重启快,且保留所有打开的标签页和编辑状态
- 如果刚加了
"**/coverage/**": true却还在结果里看到 coverage 目录,大概率就是缓存没刷新
真正容易被忽略的是:这个缓存机制让配置“看起来没生效”,但其实只是延迟暴露——下次打开新窗口或重载后,才真正起效。











