search.exclude配置错一个字符就完全失效：必须用**/开头的glob格式、正斜杠、值为布尔true，否则静默失效；临时排除在搜索面板“Files to exclude”中设置且优先级更高。
search.exclude 配置错一个字符就完全失效
VSCode 的全局搜索（Ctrl+Shift+F）默认不跳过任何目录，node_modules、dist、.log 文件全都会被扫——不是它“太勤快”，而是你没配或配错了 search.exclude。它不读 .gitignore，也不继承 files.exclude，只认这个字段，且格式极其敏感。
常见错误包括：
-
"node_modules": true→ 缺少**/前缀，只匹配项目根目录下叫node_modules的文件（几乎不存在） -
"**\node_modules": true→ Windows 下也必须用正斜杠/，反斜杠会被整个忽略 -
"**/*.log": "true"→ 值必须是布尔值true，字符串"true"会导致该条规则静默丢弃 -
"*.log": true→*不跨目录，只匹配当前目录下的.log文件，子目录里全漏掉
正确写法统一用："**/node_modules": true、"**/*.log": true、"**/coverage/**": true（结尾加 /** 更明确语义，但不加也生效）。
临时排除比改配置更快，但逗号不能有空格
打开搜索面板后，右上角点 ⋯ → «Files to exclude»，填入规则即可本次生效，关掉面板自动清空。它的优先级高于 search.exclude，所以搜出不该有的结果，第一反应就是检查这里有没有残留内容。
多个路径用英文逗号分隔，且逗号前后绝对不能有空格：
- ✅
**/tests/**,**/mocks/**,**/dist/** - ❌
**/tests/**, **/mocks/**→ 第二个规则因开头空格被解析失败，静默失效
典型场景：
- 确认某函数是否只在
src/下使用：临时填**/tests/**,**/scripts/** - 调试时怀疑
dist/里旧代码干扰：填**/dist/**，搜完立刻清空
files to include 是白名单，填错等于“搜不到”
如果搜索结果为空，但你知道关键词肯定存在，大概率是误用了 files to include。它不是“额外加几个目录”，而是只搜这里面的路径，其他一概不碰。
常见陷阱：
-
packages/core→ 缺**/前缀，只匹配根目录下名为packages/core的路径，子模块里的全漏 -
src/**/*.ts→ 看似合理，但**在中间会匹配任意深度，可能意外包含src/test/utils.ts；如只想 src 根下所有.ts，应写src/*.ts -
api/**/*.go,cmd/**/*.go→ 多路径必须严格逗号分隔，无空格，否则第二段无效
填错不会报错，只是结果变少甚至为零，容易误判为“关键词不存在”或“搜索功能坏了”。
Replace in Files 和 Replace All 完全是两回事
批量过滤不只是为了看，常用于后续替换。但很多人点了 Replace All 就以为改完了——其实它只改内存高亮，文件标题栏出现 ● 是假象，关掉再打开就还原。
真正写入磁盘的是点击右上角两个重叠文档图标（Replace in Files），它会：
- 加载所有匹配文件（包括未打开的）
- 执行替换并触发保存逻辑
- 跳过只读文件（右下角显示
Read-only），需手动解除或提权运行 VSCode
注意：search.exclude 同样拦在这里——即使你看到搜索结果里有某文件，只要它路径命中 search.exclude 规则，Replace in Files 就不会动它。临时绕过方法：搜索面板右上角点 ⋯ → 取消勾选「使用排除设置」。
最易被忽略的一点：glob 模式里的 **/api/** 会排除所有含 api 的路径（比如 src/utils/apiClient），而不是仅限 src/api/。要精确控制范围，必须写成 src/api/** 或 packages/api/** 这类带明确前缀的模式。
