VSCode全局搜索默认只扫描当前工作区文件,需用search.exclude配置**/cache等glob规则排除项目内缓存目录;格式须为正斜杠、**/开头、值为true,且修改后需重载窗口或清索引才生效。

VSCode 的全局搜索默认不会扫描系统级本地缓存数据(比如 AppData、~/Library/Caches),它只搜你当前打开的工作区目录下的文件。 所以你真正要限制的,不是“本地缓存数据”,而是项目里那些**模拟缓存行为的目录**——比如 node_modules、dist、coverage、.next、build,或者你自己生成的 cache/、tmp/ 文件夹。它们物理上就在工作区内,VS Code 会照单全收地扫。
search.exclude 必须写对 glob 格式才生效
很多人配了 "search.exclude" 却发现 cache/ 还在搜索结果里,根本原因是规则被静默忽略。VS Code 对格式极其敏感:
- 路径必须用正斜杠
/,Windows 用户写**\cache完全无效 - 必须以
**/开头,写"cache"或"cache/"不匹配任何实际路径(真实路径是src/cache/或packages/app/cache/) - 值必须是布尔值
true,不能是字符串"true"或数字1 - 规则写在
.vscode/settings.json(推荐)或用户settings.json中才有效,写进package.json或tsconfig.json是白忙活
正确示例:
{
"search.exclude": {
"**/cache": true,
"**/tmp": true,
"**/.next": true,
"**/build": true
}
}
为什么改完配置还是搜出 cache/ 里的文件
不是配置没生效,而是 VS Code 搜索依赖本地索引缓存,改完 search.exclude 后旧索引还在跑。尤其在 monorepo 或大项目中,延迟明显:
- 先按
Ctrl+Shift+P→ 输入Developer: Reload Window强制重载(比关掉再开快,且保留所有标签页) - 如果仍不行,删掉项目根目录下的
.vscode/.search文件夹(如果存在),让 VS Code 下次搜索时强制重建索引 - 检查搜索面板右上角的
Files to exclude输入框是否非空——它优先级高于search.exclude,填错格式(比如逗号后多空格)会导致整条规则失效
临时排除某次搜索中的缓存目录
不想动配置?直接在搜索面板里操作:
- 打开
Ctrl+Shift+F,在右上角点⋯→ «Files to exclude» - 填入
**/cache/**,**/tmp/**(注意:英文逗号分隔,不能有空格) - 本次搜索立即跳过,关闭面板自动清空,不污染长期设置
这个方式特别适合调试时临时确认:某个关键词到底是不是只出现在源码里,还是被 cache/ 里旧生成的文件干扰了。
最易被忽略的一点:VS Code 搜索不区分“Git 删除”和“物理删除”。如果你删了 cache/ 但没 git rm --cached -r cache/,Git 索引里还记着它,某些插件或底层 ripgrep 调用可能仍会扫到残留路径——此时光靠 search.exclude 不够,得配合清理 Git 状态或直接删索引目录。


















