search.exclude必须写在.vscode/settings.json或用户settings.json中才生效,写入package.json等其他文件无效;路径需为glob模式如"**/dist":true,且修改后需重载窗口或删除.vscode/.search刷新索引。

search.exclude 配置必须写在 .vscode/settings.json 或用户 settings.json 才生效
很多人把 search.exclude 往 package.json、tsconfig.json 或 eslint.config.js 里一塞就以为完事了——VSCode 根本不读这些文件。它只认两个地方:.vscode/settings.json(推荐,可提交到团队)或用户级设置(Ctrl+, → 打开设置 JSON)。工作区设置会覆盖用户设置,但仅限当前项目生效。
排除 dist、build 等目录,用 "**/dist": true 而不是 "dist/**": true
路径是 glob 模式,且始终相对于工作区根目录。写 "dist/**" 只匹配根目录下的 dist,而实际项目可能是 packages/web/dist 或 src/client/dist,根本扫不到。正确写法是:
-
"**/dist": true—— 排除所有层级的dist文件夹(含子文件) "**/build": true-
"**/public": true(如果 public 是纯静态资源,非源码) -
"**/out": true(常见于 TS 输出)
注意:"dist": true 本身也有效(VSCode 默认递归),但加 **/ 更稳妥,尤其在 monorepo 中。
改完 search.exclude 搜索结果还不更新?索引没重建
VSCode 搜索依赖本地缓存索引,修改配置后不会自动刷新。你搜出的“dist/index.html”很可能来自旧索引。必须手动触发重建:
- 快捷方式:
Ctrl+Shift+P → 输入 workbench.action.reloadWindow → 回车(比关掉再开快得多) - 或删掉
.vscode/.search文件夹(如果存在),重启后自动重建 - 别信“重启 VSCode”——关掉再打开 ≠ 重载窗口,索引照样没清
另外检查右下角搜索面板的“使用 Exclude 设置”是否勾选;临时想搜 dist 里的内容,直接取消勾选即可,不用改配置。
别和 files.exclude 混用,它们管的事完全不同
search.exclude 只影响 Ctrl+Shift+F 全局搜索;files.exclude 控制左侧资源管理器里显示哪些文件。两者规则写法一样,但作用域隔离:
- 想让
dist不出现在搜索结果里 → 放search.exclude - 想让
dist在左侧文件树里直接消失 → 放files.exclude - 两者都配,才真正“眼不见心不烦”
最常被忽略的是:某些 Git 插件或 Workspace Trust 设置为“受限”时,会静默禁用部分 search.exclude 规则,建议检查插件行为或临时切到“完全信任”验证。


















