如何设置VSCode全局搜索忽略特定文件类型？

本文共计960个文字，预计阅读时间需要4分钟。

VSCode的`search.exclude`配置不支持正则表达式，只支持glob模式。因此，使用`**/*.log`或`*.log`都无法生效。原因可能是前者只匹配当前目录，而后者不符合glob语法。

正确的方式是使用`**/log`开头，例如：

常见错误现象：

• "*.log": true：只排除项目根目录下的 .log 文件，子目录里的全被扫到
• ".log": true：配置不被识别，VSCode 直接忽略整条规则
• "**/*.log" 后面多加了空格，比如 "**/*.log ": true：key 带空格导致解析失败

正确写法示例（放进 .vscode/settings.json）：

{ "search.exclude": { "**/*.log": true, "**/*.tmp": true, "**/coverage/**": true } }

排除文件类型时别漏掉 **/ 前缀，否则只作用于根目录

glob 模式中，** 表示“任意深度的子目录”，没有它就只是“当前目录”。比如 "dist/*.js" 只跳过根目录下 dist/ 里的 JS，但 src/dist/*.js 还是会被搜到。

使用场景：

• 想彻底屏蔽所有构建产物：用 "**/dist/**/*.js" 而不是 "dist/**/*.js"
• 排除测试文件但保留源码：写 "**/*.test.js"，别写 "*.test.js"
• 排除 TypeScript 编译输出：需要同时配 "**/*.js" 和 "**/*.d.ts"，因为 TS 默认不删 .js

注意：**/ 是必须的，不是可选项；VSCode 不会自动补全或容错。

多个文件类型用不同 key 写，不要塞进一个字符串里

search.exclude 是对象结构，每个要排除的模式必须是独立的 key，值为 true。不能写成 "**/*.log,**/*.tmp": true —— 这会被当做一个路径字符串，而 VSCode 不支持逗号分隔的单个 key。

容易踩的坑：

• 复制粘贴别人给的“一行配置”，没拆成多个键值对
• 在设置界面点“Add Pattern”时，误把多个模式用逗号连着填进一个输入框
• 用插件自动生成配置，结果输出格式是数组而非对象

正确结构只能是这样：

{ "search.exclude": { "**/*.log": true, "**/*.tmp": true, "**/*.swp": true } }

排除后搜索仍出现目标文件？先查是否被其他规则覆盖

files to exclude 输入框（搜索面板右上角）的优先级高于 search.exclude。如果临时填了 !**/*.log 或留空，可能意外取消了排除效果。

排查步骤：

• 打开搜索面板（Ctrl+Shift+F），看右上角 files to exclude 输入框是否非空
• 检查有没有插件注入了额外规则（比如 GitLens 在“受限工作区”下可能绕过 search.exclude）
• 确认改的是工作区 .vscode/settings.json，而不是用户级设置——多根工作区下，只有当前激活根目录的配置生效
• 删掉 .vscode/.search 文件夹（如果存在），强制重建搜索索引

真正容易被忽略的是：VSCode 的 glob 匹配完全基于字符串路径，不解析软链接、不读 .gitignore、也不管文件是否被 Git 跟踪。你写的每一条 **/*.log，都得手动和项目实际路径结构对得上。