VSCode全局搜索搜不到文件主因是索引未更新、排除规则误配或PCRE2正则引擎复用旧快照；需禁用search.usePCRE2并彻底重启、清理WorkspaceStorage索引目录、检查search.exclude配置，并用ripgrep验证底层是否可查。
VSCode全局搜索搜不到已存在的文件，大概率不是“没搜到”，而是索引没反映当前真实状态——它还在用旧快照、被排除规则拦住、或正则模式误启用。直接删缓存目录不能解决问题，必须针对性清理索引机制本身。
关掉 search.usePCRE2 并重启 VSCode
启用 PCRE2 正则引擎（search.usePCRE2）时，VSCode 会复用旧索引快照，尤其在 Git 仓库里频繁删改后，已删文件仍可能出现在结果中。这不是 bug，是索引未及时失效的表现。
- 打开
settings.json（命令面板 →Preferences: Open Settings (JSON)） - 添加或修改：
"search.usePCRE2": false - 必须完全退出 VSCode（包括托盘进程），再重新启动
- 首次搜索会触发重建索引，稍等几秒再查，结果才可信
禁用后，^foo.*bar$ 这类基础正则仍可用，但 (?i) 等 PCRE2 特有语法将失效。
清空 search.history 和重置 workspaceStorage 索引目录
search.history 是设置项，不是缓存，但它会让下拉列表反复推荐旧关键词，干扰你判断是否真搜到了残留内容；而真正的文件索引藏在 WorkspaceStorage 里，每个工作区一个独立目录，删它才等于“重做一遍扫描”。
- 在
settings.json中搜索"search.history"，整行删掉（包括键和值） - 找到对应工作区的
WorkspaceStorage目录：
Windows：%APPDATA%\Code\WorkspacesStorage\<hash>\workspace.json</hash>
macOS：$HOME/Library/Application Support/Code/WorkspacesStorage/<hash>/workspace.json</hash>
Linux：~/.config/Code/WorkspacesStorage/<hash>/workspace.json</hash> - 直接删除整个
<hash></hash>文件夹（不是只删workspace.json）
下次打开该工作区，VSCode 会从头构建索引——这是最干净的重建方式。
检查 search.exclude 和 files.exclude 是否误排除目标路径
VSCode 搜索不区分“Git 删除”和“物理删除”，只要路径没被明确排除，就可能扫到。但反过来，如果路径被 search.exclude 错误覆盖，哪怕文件就在眼皮底下也搜不到。
- 确认你改的是
search.exclude，不是files.exclude（后者只影响资源管理器显示） - 检查是否有通配符写错，比如
"**/old-folder/**": true漏了结尾斜杠，实际应为"**/old-folder/**": true或更稳妥的"**/old-folder/**": true - 临时加一条强制包含：
"search.exclude": {"**/old-folder/**": false}，看是否恢复可见 - 运行
git ls-files --deleted，如果目标文件出现在输出里，说明 Git 索引还记着它，需执行git rm --cached <file></file>后提交
验证是否真被忽略：用 ripgrep 绕过 VSCode 逻辑直查
VSCode 搜索底层用的是 ripgrep（rg），但加了一层过滤逻辑。当怀疑是 VSCode 自身行为导致漏搜时，跳过它直接调用 rg 能快速定位问题根源。
- 确保系统已安装
rg（macOS/Linux 用brew install ripgrep，Windows 用choco install ripgrep） - 在项目根目录运行：
rg "your_search_term" --no-ignore -l，--no-ignore关闭所有 ignore 规则，-l只列文件路径 - 如果
rg能列出文件，说明 VSCode 的search.exclude或.gitignore配置有问题；如果rg也找不到，那文件真不在可读路径里（权限、挂载、符号链接断裂等）
这个步骤容易被跳过，但它能立刻区分问题是出在 VSCode 配置层，还是文件系统层——省掉一半无效排查时间。
