VSCode全局搜索搜不到中文，主因是文件未被正确索引：编码非UTF-8、search.exclude误排除、正则未启用(?u)模式或rg.exe异常。需依次排查编码、排除规则、正则设置及索引状态。
VSCode 全局搜索搜不到中文，90% 的情况不是功能坏了，而是文件根本没被正确读进索引——编码错、路径被拦、rg.exe 没拿到字节，三者任一成立，中文就“隐身”。
文件实际编码不是 UTF-8，rg.exe 直接跳过解析
VSCode 右下角显示 UTF-8 不代表文件真是 UTF-8 存的。GBK 编码的 JS 文件被强行当 UTF-8 读，rg.exe 解析失败，内容压根不进索引，搜当然为空。
- 点击右下角编码标识 → 选
Reopen with Encoding→ 依次试GBK、GB2312，看中文是否正常显示 - 确认后点
Save with Encoding→ 永久转成UTF-8（注意：这会真实改写文件字节） - 批量处理慎用：
iconv -f GBK -t UTF-8 src/*.js > converted/，务必先备份原文件 - 预防措施：在工作区
.vscode/settings.json中加"files.encoding": "utf8"，强制新文件默认存为 UTF-8
search.exclude 静默过滤整个目录，连文件名都不扫
search.exclude 是全局搜索的“闸门”，一旦匹配上，对应路径下所有文件内容全被跳过，不是搜不到，是根本没看。
- 检查设置里是否有误配：
"**/src/**"这种规则会干掉整个 src，而你以为只排除构建产物 - 通配符必须写全：
"node_modules"可能误中my_node_modules，正确写法是"**/node_modules/**" - 临时验证：在搜索面板右下角点
!图标 → 关掉Use Exclude Settings and Ignore Files，如果立刻能搜到，就是它在拦 - 远程开发（WSL/SSH）下，
files.exclude有时也会间接干扰索引，建议统一用search.exclude管控
正则模式开启但没加 (?u)，\w 和 . 对中文失效
点开 .* 启用正则后，引擎默认只认 ASCII 字符；搜 函数 或 ^\s*export \w+ 会直接失败，报错 Range out of order in character class 也很常见。
- 所有中文正则开头必须加
(?u)，例如：(?u)用户登录、(?u)^\s*export \w+ - 避免手写 Unicode 范围如
[\u4e00-\u9fa5]——不同字体/输入法下边界可能偏移，(?u)\w更稳 - 普通文本搜索不需要正则，误点
.*是高频失误，搜完记得关掉
rg.exe 被系统拦截或索引损坏，搜索卡在“正在搜索”
VSCode 底层靠 rg.exe 实时扫描，但它很脆弱：企业加密软件会拦截未打开文件的磁盘读取，NTFS 监听丢事件会导致索引滞后，单文件超 search.maxFileSize（默认约 50MB）直接跳过。
- 企业环境：把 VSCode 安装目录下的
rg.exe路径（如resources/app/out/vs/workbench/contrib/search/browser/）加进绿盾/北信源白名单 - 索引损坏迹象：重启 VSCode 后恢复正常 → 删掉工作区下的
.vscode/.search目录再重开 - 大文件搜不到：在设置里搜
search.maxFileSize，调高至100（单位 MB） - 手动验证
rg是否可用：终端进项目根目录，执行rg "关键词" --type=javascript，看是否返回结果
真正卡住人的，往往是编码和 search.exclude 这两个点叠加：文件是 GBK 的，又被 **/src/** 规则排除了，你连它存在都看不到。排查时别跳步，先确认编码，再看排除规则，最后动正则和索引——顺序错了，花半天也白调。
