VSCode不支持直接设置搜索深度，需通过search.include白名单限定范围或search.exclude排除路径间接实现；需同步配置files.watcherExclude并重载窗口，必要时手动清除.vscode/.search缓存。
VSCode不支持直接设置搜索深度层数
它没有类似 --maxdepth 3 这样的原生参数。所谓“限制深度”，实际是靠排除（search.exclude）或限定（search.include）路径来间接实现的——不是砍掉递归层数，而是不让它进那些深目录。
用 search.include 白名单锁定有效范围
比“排除深目录”更可靠：只让 VSCode 扫描你明确需要的子目录，其余一律跳过。尤其适合 src、lib、test 等结构清晰的项目。
-
"${workspaceFolder}/src/**"：只扫 src 下所有层级（不限深度，但限起点） -
"${workspaceFolder}/packages/*/src/**"：monorepo 中只扫每个包的 src（*是一层通配，不递归） - 避免写
"${workspaceFolder}/**/src/**"—— 这会匹配任意深度下的 src，反而扩大范围 - 多个路径用逗号分隔，值必须为
true，不能省略引号
search.exclude 排除时注意 glob 语义陷阱
很多人以为写 "node_modules" 就能排除，结果无效。VSCode 的 glob 是路径匹配，不是文件夹名匹配：
- ✅ 正确：
"**/node_modules/**"—— 匹配任意深度下的 node_modules 及其全部内容 - ❌ 无效：
"node_modules"或"node_modules/"—— 不带**/前缀，根本不会命中子目录里的 node_modules - ⚠️ 注意：
"**/dist/**"会排除src/utils/dist/config.js，但"dist/**"只排除根目录下的 dist - 排除构建产物时，建议同时写
"**/build/**"、"**/dist/**"、"**/out/**"，不同工具输出位置不统一
真正卡住搜索的不是“深度”，是文件监视器没关
改完 search.exclude 发现还是慢？大概率是 files.watcherExclude 没同步配。VSCode 启动后会为所有目录建 inotify 监听，哪怕你从不搜它们——node_modules 里几千个文件持续触发 stat，CPU 就上去了。
- 必须补上：
"files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true } - 值必须是布尔
true，写成"true"字符串就失效 - 这个配置和
search.exclude路径要完全一致，否则监视器照常跑 - 改完记得 Reload Window，否则旧 watcher 不释放
最易被忽略的一点：VSCode 的搜索索引是缓存的。.vscode/.search 文件夹不删，旧索引可能继续返回已被排除目录里的结果——哪怕配置全对，也得手动清一次缓存才真正生效。
