VSCode 的 search.exclude 必须用正确 glob 语法(如 "**/node_modules": true)才能排除 node_modules,它不读 .gitignore,修改后需重载窗口或删 .vscode/.search 缓存生效。

search.exclude 必须写对 glob 才能真正排除 node_modules
VSCode 默认不跳过 node_modules,不是它“没做优化”,而是你没配或配错了 search.exclude。它完全不读 .gitignore,也不继承 files.exclude,只认这个字段本身。
常见错误写法:"node_modules": true、"node_modules/**": true、"*.node_modules"——这些全被静默忽略,搜出来还是满屏第三方代码。
-
"**/node_modules": true✅ 推荐:匹配任意层级下的同名目录(monorepo 里也生效) -
"/node_modules": true⚠️ 仅限根目录:适合单包项目,但多数现代项目不适用 - 值必须是
true(布尔值),不能是"true"(字符串) - 路径必须用正斜杠
/,Windows 下写**\node_modules也无效
为什么改了配置还搜出 dist/node_modules 里的结果?
VSCode 搜索依赖本地索引缓存,修改 search.exclude 后不会自动刷新已有搜索结果。尤其在大项目里,旧索引可能持续返回已被排除路径下的文件。
- 第一反应不是重装插件,而是按
Ctrl+Shift+P→ 输入Developer: Reload Window回车 - 比完全重启快,且保留所有打开的标签页和调试状态
- 如果仍不行,手动删掉
.vscode/.search文件夹(如果存在),强制重建索引 - 检查搜索面板右上角「⋯」→ «Files to exclude» 是否非空——它优先级更高,填错格式(比如逗号后多空格)会导致整条规则失效
临时排除比永久配置更常用,但格式一样
调试时怀疑某段逻辑被 dist/ 里的旧代码干扰,或想确认关键词是否只出现在 src/ 下,直接在搜索面板右下角输入框填规则就行,关掉面板自动清空。
- 填
**/dist/**或**/tests/**✅ - 多个规则用英文逗号分隔:
**/node_modules/**,**/build/**✅;加空格就失效:**/node_modules/**, **/build/**❌ - 它用的也是 glob,不是正则,不支持
~、$HOME这类变量 - 别写
-exclude:node_modules——那是命令行工具语法,VSCode 搜索面板不认
别为了“彻底”写太宽泛的 glob
排除规则不是越多越好,写法不当反而拖慢搜索速度,甚至让部分结果丢失。
- 避免嵌套多个
**:"**/a/**/b/**/c.js"匹配开销指数增长 - 别写
"**/.*"排除所有隐藏文件——每个文件都触发一次扫描,大型项目明显卡顿 - 想排除日志但保留
.git?单独写"**/*.log": true,别试图一条规则通吃 - 团队协作时,把
search.exclude写进.vscode/settings.json并提交 Git,比靠个人用户设置更可靠
配置生效的关键不在“写了多少”,而在“路径基准是否理解正确”——search.exclude 的 glob 始终相对于工作区根目录,不是当前打开的文件夹,也不是系统家目录。这点最容易被忽略。











