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。它不是“额外加几个目录”，而是只搜这里面的路径，其他一概不碰。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

常见陷阱：

• 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/** 这类带明确前缀的模式。