vscode全局搜索搜不到内容，主因是文件未被索引，涉及排除规则、编码不兼容、rg.exe拦截、权限或索引损坏等；需按快捷键响应→文件可见性→编码→排除规则→索引完整性顺序排查。
VSCode 全局搜索搜不到内容，八成不是功能坏了，而是文件压根没进索引——索引范围被限制、编码不兼容、路径被排除或权限卡住，都会导致“搜得到文件名，搜不到内容”。
search.exclude 和 files.exclude 到底谁在拦路
这两个设置都可能让文件彻底消失在全局搜索里，但作用机制不同：
-
search.exclude直接决定 Ctrl+Shift+F 搜索时跳过哪些路径，比如"**/dist/**": true会连dist/index.html里的中文注释都不读 -
files.exclude主要影响资源管理器显示和 Ctrl+P 文件跳转，但在远程开发（WSL/SSH）或某些插件下，它也会间接干扰索引构建 - 通配符写错很致命：
"node_modules"（缺前后**/）可能误匹配src/my_node_modules/，而"**/node_modules/**"才是安全写法 - 临时验证方法：在搜索面板右下角点
!图标，关掉「使用排除规则」；如果立刻能搜到，说明就是它在拦
UTF-8 编码不是默认就管用，得看文件实际存的啥
VSCode 只对真正以 UTF-8 编码保存的文件做全文索引。GBK、GB2312 或 ANSI 编码的文件，哪怕右下角显示“UTF-8”，也只是 VSCode 错误识别了——内容根本没被解析，更别说匹配中文了。
- 右下角点击当前编码（如
UTF-8），选「Reopen with Encoding」，依次试GBK、GB2312，看中文是否正常显示；确认后点「Save with Encoding」永久转换 - 批量处理建议用命令行：
iconv -f GBK -t UTF-8 src/utils.js > src/utils.utf8.js（务必先备份） - 工作区统一预防：在
.vscode/settings.json中加"files.encoding": "utf8"，避免新文件再存成非 UTF-8 - 注意：Git 提交前需同步团队，混用编码会导致 diff 异常
rg.exe 被拦截、索引卡住、大文件被跳过，都是静默失效
VSCode 底层用 rg.exe（ripgrep）做实时扫描，但它很容易被系统级因素打断：
- 企业加密软件（绿盾、北信源、明朝万达）会拦截未打开文件的磁盘读取——文件一关闭，
rg.exe就返回空结果；解决办法是把 VSCode 安装目录下的rg.exe路径（通常在resources/app/out/vs/workbench/contrib/search/browser/）加进白名单 - 索引损坏常见于 Windows NTFS 监听丢事件，或 WSL2
fs.inotify.max_user_watches不足；可删掉工作区下的.vscode/.search目录后重启 VSCode - 单文件超过默认
search.maxFileSize（约 50MB）会被直接跳过；在设置里搜该配置，调高如100（单位 MB） - 禁用所有插件测试：
code --disable-extensions启动，若恢复，再逐个启用排查（Vim/Emacs 模拟器、Prettier 类格式化插件最常干扰）
Ctrl+Shift+F 按下没反应？别急着重装，先查输入法和热键
Windows 用户最常踩的坑：微软拼音/五笔默认把 Ctrl+Shift+F 绑定为「简繁切换」，VSCode 根本收不到按键事件——按下去毫无反馈，连搜索面板都不弹。
- 右键任务栏输入法图标 → 「设置」→ 「按键设置」→ 关掉「简体/繁体中文输入切换」
- 其他抢热键的软件：QQ、钉钉、OBS、Edge DevTools、有道词典；临时退出它们逐一验证
- 在 VSCode 中按
Ctrl+K Ctrl+S打开快捷键面板，搜workbench.action.findInFiles，确认绑定状态；若显示「已禁用」或空白，手动加回：{"key":"ctrl+shift+f","command":"workbench.action.findInFiles"} - Mac 用户注意：系统偏好设置 → 键盘 → 快捷键 → 输入源中也可能冲突
真正难排查的，往往是多个限制叠加：GBK 编码文件 + 被 search.exclude 误杀 + rg.exe 被加密软件拦截。建议按「快捷键响应 → 文件是否可见 → 编码是否正确 → 排除规则是否生效 → 索引是否完整」顺序一步步过，别跳步。
