必须配置 search.exclude,否则 Ctrl+Shift+F 会误搜 dist/build/public 等打包目录,导致干扰或误改;需在 .vscode/settings.json 中添加 "**/dist": true、"**/build": true、"**/public/**": true、"**/node_modules": true。

search.exclude 必须配,否则 Ctrl+Shift+F 会扫进 dist 和 build
VSCode 默认不跳过任何目录,dist、build、public 这些前端打包产物一旦混在搜索结果里,轻则干扰定位,重则误改生成代码导致下次构建丢失修改。这不是“搜得慢”,而是根本搜不准。
关键动作只有一步:在项目根目录的 .vscode/settings.json 中写入 search.exclude 规则。它和 files.exclude 无关,也不能靠 .gitignore 代劳——VSCode 完全不读那玩意儿。
-
"**/dist": true—— 排除所有层级下的dist目录(含子目录) -
"**/build": true—— 同理覆盖 Webpack/Vite/Next.js 等不同构建输出路径 -
"**/public/**": true—— 建议加/**,避免漏掉 public 下的index.html或静态资源 -
"**/node_modules": true—— 前端项目必加,第三方包里的同名函数常把人绕晕
为什么 **/public 不如 **/public/** 可靠
VSCode 的 glob 匹配对路径层级敏感。**/public 能匹配 /public 和 /src/public,但可能漏掉 /public/favicon.ico 这类直接在 public 根下的文件——因为匹配器认为它“不属于目录层级”,而 **/public/** 明确表示“public 目录及其全部内容”。
实测中,未加 /** 时,某些 Vite 项目仍会在搜索结果里返回 public/assets/xxx.js;补上后立即消失。
- 错误写法:
"public": true—— 只匹配根目录下叫 public 的文件(不是目录) - 危险写法:
"**/public/*"——*不匹配多层子路径,public/a/b/c.png会被放过 - 推荐写法:
"**/public/**": true—— 语义清晰,覆盖完整
临时排除比改配置更快,但要注意逗号格式
调试时突然想确认某个关键词是否只存在于 src/,不用改配置、也不用重载窗口,直接打开搜索面板(Ctrl+Shift+F),点右上角 ⋯ → Files to exclude,填进去就行。
这个输入框优先级高于 search.exclude,填错会立刻生效——包括填错的后果。
- ✅ 正确:
**/dist/**,**/build/**,**/public/**(英文逗号,无空格) - ❌ 失效:
**/dist/**, **/build/**(逗号后带空格,第二条被静默丢弃) - ❌ 失效:
**\dist\**(Windows 用户也必须用正斜杠/,反斜杠完全不识别) - ⚠️ 注意:关掉搜索面板后自动清空,适合一次性验证,不适合长期依赖
files.exclude 和 search.exclude 必须分开配,不能只配一个
很多人只配了 files.exclude,发现资源管理器里 dist 消失了,但 Ctrl+Shift+F 还是满屏匹配——因为 search.exclude 是独立字段,VSCode 不会自动同步。
二者作用完全不同:
-
files.exclude控制左侧文件树、Ctrl+P文件列表、新建/保存路径提示 -
search.exclude只影响全局搜索(Ctrl+Shift+F)的结果范围 - 都用 glob,但值必须为布尔型
true,写成"true"字符串就整个规则失效
真正干净的前端工作区,两个字段都要有对应项,比如同时写 "**/dist": true 在两者之中。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











