必须手动配置search.exclude，否则VSCode默认扫描node_modules、dist等目录；最常见失效原因是路径格式错误（如缺**/前缀）、未重载窗口或规则写错文件，且VSCode静默忽略不报错。
必须手动配 search.exclude，否则 VSCode 默认照扫 node_modules、dist 等目录——哪怕它们早被写进 .gitignore，也完全不影响搜索行为。
为什么 search.exclude 配了还不生效
最常见原因是路径写错或缓存没刷新，VSCode 不会报错，而是静默忽略整条规则：
-
"node_modules"❌ —— 缺少**/前缀，只匹配根目录下同名文件，monorepo 或嵌套结构里全失效 -
"**\node_modules"❌ —— Windows 用户易用反斜杠，但 glob 解析器只认正斜杠/ -
"**/node_modules/"❌ —— 多了个结尾/，实际目录名不含该字符，匹配失败 - 改完配置后没重载窗口：按
Ctrl+Shift+P→ 输入Developer: Reload Window才能清掉旧索引 - 误写在
tsconfig.json或package.json里：这些文件 VSCode 搜索压根不读，只认.vscode/settings.json或用户级settings.json
search.exclude 和 files.exclude 到底怎么分工
两者作用完全不同，混用会导致预期外行为：
-
search.exclude只影响Ctrl+Shift+F全局搜索，决定哪些路径不参与文本扫描 -
files.exclude控制资源管理器里是否显示文件/文件夹，也会影响部分语言服务（如 TS 路径提示），但不控制搜索范围 - 想让
node_modules既不显示也不被搜，得同时配两个："**/node_modules": true分别写进search.exclude和files.exclude -
.git目录建议只加进files.exclude：它不含业务代码，没必要隐藏搜索，但侧边栏里确实不需要看到
哪些路径该加、哪些不该加、加法有什么讲究
排除不是越多越好，有些路径加错反而破坏开发体验：
- 必加：
"**/node_modules"、"**/dist"、"**/build"、"**/coverage"—— 它们体积大、内容不可编辑、结果干扰强 - 慎加：
"**/*.min.js"、"**/*.map"—— 如果你偶尔要查压缩包里的报错堆栈，排除后就搜不到源映射线索 - 别加：
"src/**"、"lib/**"这类源码目录 —— 排除后等于主动放弃搜索主战场 - 推荐写法：
"**/dist/**"比"**/dist"更稳妥，确保跳过dist/esm/utils.js这类深层路径 - 想临时跳过某次搜索？打开
Ctrl+Shift+F面板 → 点右上角 ⋯ → «Files to exclude» → 填**/node_modules/**,**/dist/**（英文逗号分隔，无空格）
别漏掉 files.watcherExclude，否则搜索前就卡住
很多人配完 search.exclude 还觉得慢，是因为文件监视器（file watcher）仍在后台反复扫描 node_modules、.git/objects 这些目录，导致搜索准备阶段就卡顿：
- 必须同步配
files.watcherExclude，且规则和search.exclude高度重合："**/node_modules/**": true、"**/.git/objects/**": true - watcher 排除的是“监听”，不是“搜索”，它防止 VSCode 在文件变更时触发无谓的重建索引
- 这个配置不写，哪怕
search.exclude写得再准，大项目里 Ctrl+Shift+F 点下去也要等好几秒才弹出搜索框
真正起效的从来不是“配了什么”，而是“配对没配对、有没有被读到、索引有没有重建”。路径写错一个字符、缓存没清、watcher 没关——三者任一存在，优化就归零。
