VSCode没有search.depth配置项，所谓“搜索深度”实为search.followSymlinks与文件系统遍历逻辑共同作用的结果：默认followSymlinks为true，但遇符号链接循环时自动中断；深层目录未被搜索主因是search.exclude通配符不匹配、inotify监听失效或rg.exe被拦截，而非深度限制。
search.followSymlinks 和 search.depth 是什么关系
VSCode 没有名为 search.depth 的配置项——这是个常见误解。真正控制搜索“深度”的，是 search.followSymlinks 和底层文件遍历逻辑共同作用的结果，但它的行为不像目录层级计数器那样直观。所谓“深度限制”，其实是 VSCode 对符号链接（symlink）的默认处理策略 + 文件系统遍历时的隐式递归保护机制，不是用户可直接设为“5层”或“10层”的参数。
为什么搜着搜着就停在某一层不往下进了
这不是深度被“设限”，而是以下任一情况触发了静默跳过：
-
search.followSymlinks默认为true，但若 symlink 指向循环路径（如 A → B → A），VSCode 会主动中断遍历，避免无限递归——此时你看到的“卡在第三层”，其实是它检测到潜在环路后放弃继续 - 工作区根目录下存在大量嵌套子模块（比如 monorepo 中 packages/a/packages/b/...），而
search.exclude规则写得不够宽泛（如只写了"packages/**"却漏了"**/packages/**"），导致部分深层路径根本没进候选列表 - 某些远程文件系统（WSL2、SSH FS）的 inotify 事件丢失，VSCode 无法感知深层子目录变更，索引未更新，后续搜索自然不包含新生成的深层文件
想让搜索真正覆盖深层嵌套目录，该调哪些配置
没有“调深度”这一说，只有三类操作能影响实际扫描范围：
- 确认
search.followSymlinks为true（默认值，一般不用动）；如果明确知道无循环链接且需穿透挂载点，可保留开启 - 检查并收紧
search.exclude：用"**/node_modules/**"替代"node_modules"，用"**/dist/**"替代"dist"，确保 glob 能匹配任意层级下的目标目录 - 若项目结构极深（>15 层），且确认是 inotify 监听失效（常见于 WSL2），需手动增大系统限制：
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
搜不到深层目录里的文件？先验证是否真被跳过
别急着改配置，先做两件事：
- 在搜索框右上角点
⋯→ 选「Include」，手动输入一个确定存在的深层路径，比如packages/core/src/utils/**，看能否搜出内容——能，则说明原先是排除规则误伤；不能，则可能是编码、权限或 rg.exe 被拦截 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，执行require('child_process').execSync('rg --version')，确认底层rg可用；再搜一次，观察是否有报错输出
真正难排查的，从来不是“搜得太深”，而是“搜的时候压根没把那个目录当回事”——路径通配写错、符号链接指向异常、系统级 inotify 限额不足，这三者比任何“深度设置”都更容易让人空转半天。
