VSCode全局搜索失效90%因文件未被读取：快捷键被输入法或软件劫持、search.exclude误过滤、编码非UTF-8、加密软件拦截或索引阻塞。
VSCode 全局搜索（Ctrl+Shift+F）失效，90% 的情况不是功能坏了，而是它根本没读到你要搜的文件——要么被规则拦住、要么编码不对、要么压根没进索引。
快捷键按了没反应？先查输入法和系统级冲突
Windows 用户最常见：微软拼音/五笔默认用 Ctrl+Shift+F 切换简繁体，直接吞掉命令；QQ、OBS、DeepL、Edge DevTools 也常劫持该组合键。
- 验证方式：
Ctrl+K Ctrl+S打开快捷键设置，搜索workbench.action.findInFiles，看右侧是否显示绑定键；若显示“无键绑定”，就是被占用了 - 临时解决：右键任务栏输入法图标 → 设置 → 关闭“简体/繁体切换”
- 长期方案：在
keybindings.json中手动加一条映射，例如：{"key":"ctrl+alt+f","command":"workbench.action.findInFiles"}
面板打开了但搜不到内容？重点盯 search.exclude 和 files to include
search.exclude 是全局搜索的“过滤开关”，比 files.exclude 更关键——后者只影响资源管理器显示，前者直接决定哪些文件进不了索引。
- 常见误配：
"**/dist": true会屏蔽整个dist/目录，哪怕你正想查打包后 JS 里的某段逻辑 -
files to include输入框留空 = 只搜当前已打开的文件（哪怕只开了一个README.md，其他所有.ts/.js都不查） - 临时绕过：在搜索面板底部点
!图标（“使用排除规则”），关掉它；如果立刻能搜到，说明就是它在拦 - 精准写法示例：
**/*,-**/node_modules/**,-**/dist/**（逗号分隔无空格，-表示局部排除）
搜得到文件名但找不到内容？检查编码、大文件和加密软件
VSCode 只对真正以 UTF-8 编码保存的文件做全文索引。GBK、GB2312 或 ANSI 编码的文件，哪怕右下角显示“UTF-8”，也只是错误识别——内容根本没被解析。
- 右下角点击当前编码（如显示
GBK），选Reopen with Encoding→ 试UTF-8；确认中文正常显示后，再点Save with Encoding永久转换 - 单文件超过
search.maxFileSize（默认约 12.5MB）会被跳过；可在设置里调高，例如："search.maxFileSize": 50000 - 企业环境常见陷阱：绿盾、北信源等加密软件会阻止 VSCode 读取未打开文件的内容；需把
rg.exe路径（通常在resources/app/out/vs/workbench/contrib/search/browser/）加进白名单
索引卡在“Indexing…”或结果明显漏掉？重建索引 + 禁用干扰插件
右下角状态栏若长期显示 Indexing… 12/842，说明 ripgrep 进程被大文件、符号链接或加密软件阻塞；索引损坏也常见于 WSL2 的 inotify.max_user_watches 不足或 NTFS 监听丢事件。
- 强制重建：删掉工作区下的
.vscode/.search目录，重启 VSCode - 快速验证插件干扰：
code --disable-extensions启动无扩展版；若恢复，再逐个启用排查（Vim/Emacs 模拟器、GitLens、Prettier 类插件最常干扰） - 检查开发者工具：
Ctrl+Shift+P→Developer: Toggle Developer Tools，筛选search或index，看是否有Indexing stalled或Failed to read file报错
真正难搞的从来不是配置项本身，而是它们之间的叠加效应——比如 files to include 和 search.exclude 同时生效时，前者优先级更高，很容易让你以为改了 search.exclude 就行，其实白名单已经窄得只剩一个目录了。
