VSCode搜索不到文件主因是文件未被索引：search.exclude规则格式错误（须glob、/开头、true值、无空格）、Files to exclude输入框非空优先级最高、非UTF-8编码文件不索引、files.exclude不影响搜索。
VSCode 搜索不到文件，90% 不是功能失效，而是它压根没读到那些文件——要么被规则静默过滤，要么编码不支持索引，要么路径根本没匹配上。
search.exclude 规则写错格式就等于没写
VSCode 对 search.exclude 的语法极其敏感，写错一个字符，整条规则就被丢弃，且不报错、不提示。
- 必须用 glob 模式，且几乎总要以
**/开头："**/node_modules"✅，"node_modules"❌（只匹配根目录） - 值必须是布尔
true，不能是字符串"true"或数字1 - 路径必须用正斜杠
/，Windows 下写**\node_modules完全无效 - 键名末尾不能有空格：
"**/dist/ "会被整个忽略 - 排除单个文件类型必须递归：
"**/*.log"✅，"*.log"❌（只扫当前目录）
临时排除输入框的优先级高于所有配置
搜索面板右上角的 Files to exclude 输入框，是排查的第一现场。只要它非空，search.exclude 就完全失效。
- 多个规则用英文逗号分隔，**不能有空格**：
**/node_modules,**/dist✅，**/node_modules, **/dist❌ - 常见误操作：调试时随手填了
**/src，关掉面板忘了清空，之后所有搜索都漏源码 - 验证方法：打开搜索面板 → 看右上角输入框是否为空 → 若非空，删掉再试一次
文件编码不是 UTF-8 就不会被索引
VSCode 默认只对 UTF-8 编码的文件做全文内容索引。GBK、GB2312、ISO-8859-1 等编码的文件，哪怕你双击能正常显示中文，Ctrl+Shift+F 也搜不到里面任何文字。
- 右下角状态栏点击当前编码（如显示
GBK），选Reopen with Encoding → UTF-8 - 确认显示正常后，再点编码 →
Save with Encoding永久转码（注意：会真实改写文件） - 批量处理可用命令行：
iconv -f GBK -t UTF-8 src/file.js > src/file_utf8.js - 为防新文件再存错，建议加配置：
"files.encoding": "utf8"
search.useIgnoreFiles 和 files.exclude 容易混淆但完全无关
files.exclude 控制左侧资源管理器是否显示文件，对 Ctrl+Shift+F 零影响；search.useIgnoreFiles 才决定是否读 .gitignore，但它只是补充 search.exclude，不是替代。
- 想让
.gitignore里的规则也生效？设"search.useIgnoreFiles": true - 想彻底禁用
.gitignore干扰？设"search.useIgnoreFiles": false - 误配
files.exclude后发现搜索还是扫node_modules？别改这里，去改search.exclude - 想同时隐藏 + 排除？两个字段都要配：
files.exclude+search.exclude
真正卡住排查进度的，往往不是规则多难写，而是默认行为和优先级关系没理清——比如 Files to exclude 输入框非空、编码不是 UTF-8、或者把 files.exclude 当成搜索开关。这些点不手动验证一遍，光改配置只会越调越乱。
