search.exclude 必须按工作区类型配置：单文件夹改用户 settings.json，多根工作区须写入 .code-workspace 的 settings 字段；值必须为 "" glob 字符串，如 "/node_modules/": ""；修改后需重启 VSCode 并检查开发者工具日志。
search.exclude 配置位置不对，改了也不生效
VSCode 的 search.exclude 是工作区级配置，不是用户全局设置——很多人在「设置 UI」里搜到它就直接改，结果只对当前打开的文件夹有效，换个项目又失效。真正要全局生效，得改用户 settings.json；但更常见的情况是：你开了多根工作区（multi-root workspace），此时 search.exclude 必须写在 `.code-workspace` 文件里才管用，settings.json 会被忽略。
实操建议：
- 确认当前是单文件夹还是多根工作区：看窗口标题栏有没有「[Workspace]」字样
- 单文件夹项目 → 改
settings.json（Ctrl+, → 右上角打开 JSON 图标） - 多根工作区 → 改对应
.code-workspace文件里的settings字段 - 别用设置 UI 界面点开关，它有时会把规则写成布尔值（如
"node_modules": true），而 VSCode 5.0+ 要求必须是 glob 字符串（如"node_modules": "**"）
排除路径写法错误，导致文件夹仍被搜到
VSCode 的 search.exclude 值是 glob 模式，不是正则，也不是简单前缀匹配。最常踩的坑是：写成 "dist/": true 或 "dist": ""，这些都不合法；或者漏掉通配符，以为 "dist": "**" 就够了，其实它只匹配名为 dist 的**文件**，不匹配文件夹。
正确写法必须满足两点：键是相对路径模式，值是 "**"（表示该路径下所有内容）。
常见场景示例：
- 排除根目录下的
build文件夹："build/**": "**" - 排除所有叫
node_modules的文件夹（无论嵌套多深）："**/node_modules/**": "**" - 排除某子目录下的临时文件：
"src/utils/temp/**": "**" - 注意斜杠方向：Windows 下也用
/，不要用\
搜索时仍扫到已排除的文件夹，可能是缓存或权限问题
VSCode 搜索有缓存机制，改完 search.exclude 后不会立刻刷新索引。更隐蔽的问题是：某些文件夹（比如符号链接指向的位置、或权限受限的 /tmp 子目录）可能被跳过排除逻辑，直接走底层文件系统扫描。
排查步骤：
- 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools，切到 Console 标签，执行搜索时看有没有exclude pattern mismatch类警告 - 临时禁用所有插件（尤其是文件系统类扩展如
GitLens、Project Manager），再试一次搜索 - 检查目标文件夹是否是符号链接：VSCode 默认不跟随 symlinks，但如果用了
"search.followSymlinks": true，而链接目标不在排除范围内，就会漏掉 - 重启 VSCode（不是重载窗口），确保搜索服务完全重建索引
和 files.exclude 混用时行为不一致
files.exclude 控制资源管理器里是否显示文件，search.exclude 才真正决定搜索范围。两者规则写法相同，但作用域不同——有人把排除规则全塞进 files.exclude，结果发现搜索照常进行，就是这个原因。
关键区别：
-
files.exclude不影响搜索，只影响左侧文件树可见性 -
search.exclude不影响文件树，只过滤搜索结果 - 如果想让某个文件夹既不显示也不被搜，两个配置都得加同一行，例如：
"node_modules/**": "**"同时出现在files.exclude和search.exclude里 - 注意顺序：VSCode 会合并用户、工作区、文件夹三级配置，后加载的覆盖前加载的，所以工作区配置能盖掉用户级
search.exclude
最麻烦的其实是路径层级嵌套和 glob 的贪婪匹配——比如 "**/dist/**" 会排除所有子目录下的 dist，但 "dist/**" 只排除项目根下的 dist；稍不注意，就漏掉深层构建产物。这种细节没法靠猜，得开开发者工具看实际匹配日志。
