必须用search.exclude+search.include双配置写在工作区根目录.vscode/settings.json中;路径须以**/开头、值为true布尔型、Windows用正斜杠、需重载窗口;include需用${workspaceFolder}展开;临时排除优先级更高;避免宽泛glob模式,同步设置files.exclude防性能问题。

直接结论:必须用 search.exclude + search.include 双配置,写在工作区根目录的 .vscode/settings.json 里,否则改了等于没改。
为什么改了 search.exclude 还是搜到 node_modules
不是配置没生效,而是你漏掉了三个关键点:
-
search.exclude的路径必须以**/开头,写成"node_modules"或"node_modules/"全部无效 - 值必须是布尔型
true,不能是字符串"true",否则整条规则被静默丢弃 - Windows 下也必须用正斜杠
/,写** ode_modules或**\node_modules完全不匹配 - 改完不重载窗口,旧索引缓存还在,结果照常返回——按
Ctrl+Shift+P→ 输入Developer: Reload Window再试
search.include 是白名单,不是“加个前缀”那么简单
想让 Ctrl+Shift+F 只扫 src 和 tests?光靠界面里填 src/** 不行,它会被当成相对路径处理,实际仍扫全工作区。
- 正确写法是:
"${workspaceFolder}/src/**": true和"${workspaceFolder}/tests/**": true - 变量
${workspaceFolder}必须展开,单独写src/**没有上下文,VS Code 不知道从哪开始算 - 多根工作区下,每个根目录的
.vscode/settings.json独立生效,${workspaceFolder}指向各自根目录 - 如果同时配了
search.include和search.exclude,exclude 依然起作用——比如 include 了src/**,但 exclude 里写了"${workspaceFolder}/src/generated/**": true,那生成文件还是被跳过
临时排除和永久排除的优先级关系
搜索面板右上角点 ⋯ → Files to exclude 填的规则,优先级高于 search.exclude。这是调试时最实用的开关,但容易踩坑:
- 多个规则用英文逗号分隔,不能有空格:
**/node_modules/**,**/dist/**✅,**/node_modules/**, **/dist/**❌(第二条失效) - 填错格式(比如漏了
**/、用了反斜杠)会导致整条规则被忽略,VS Code 不报错也不提示 - 如果搜出来不该出现的文件,第一反应不是检查
settings.json,而是先点开这个输入框看有没有残留内容 - 关掉搜索面板后自动清空,适合一次性验证,不适合长期依赖
性能陷阱:别以为排除得越狠越好
search.exclude 规则是逐条做 glob 字符串匹配的,模式越宽,开销越大:
- 避免嵌套多个
**,比如"**/a/**/b/**/c.js",匹配耗时会指数增长 - 想排除所有日志,用
"**/*.log": true就够了,别写成"**/**/*.log"或"*.log"(后者只匹配当前目录) - 如果项目里真要搜
node_modules(比如调试依赖源码),建议搭配file:*.ts或file:package.json限定文件类型,比全量扫快得多 - 真正卡顿的根源常是没同步设
files.exclude:只设search.exclude,VS Code 仍为那些目录建文件监视器,inotify 句柄爆满、CPU 持续飙高
最常被忽略的一点:VS Code 默认硬编码排除了 **/node_modules、**/.git 等目录,这些不会出现在你的 settings.json 里,但始终生效。想取消,必须显式写 "**/node_modules": false,删掉配置项没用。











