VSCode不支持直接配置搜索深度，所谓“限制深度”实为通过search.exclude排除大目录（如**/node_modules）、files to exclude临时过滤、search.maxFileSize控制单文件大小来间接实现。
VSCode 本身不提供直接配置“搜索深度层数”的设置项，所谓“限制深度”实际是通过排除路径、缩小范围、控制文件数量来间接实现的——因为 VSCode 搜索默认递归遍历所有子目录，卡顿根源从来不是“太深”，而是扫了太多不该扫的目录（比如 node_modules 里嵌套 20 层的依赖）。
search.depth 根本不存在，别白找
VSCode 官方 settings.json 文档中没有 search.depth、search.maxDepth 或类似字段。网上搜到的所谓“设置 depth=5”全是误传或混淆了其他工具（如 ripgrep 的 -d 5）。VSCode 搜索底层虽可调用 ripgrep，但其深度控制开关未暴露给用户配置界面，也不响应自定义 depth 参数。
你真正能干预的只有三件事：跳过哪些路径、只看哪些路径、单文件最大读多少字节。
用 search.exclude 精准跳过“深但无用”的目录
这是最有效、最常用的“伪深度限制”。VSCode 不会因为你写了 "**/node_modules/**" 就少扫一层，但它会彻底跳过整个 node_modules 目录树——无论它有 1 层还是 50 层嵌套。
-
"**/node_modules"：匹配任意层级下的node_modules目录（推荐写法，简洁且生效） -
"**/dist"、"**/build"、"**/target"：覆盖常见构建输出目录 -
"**/coverage"、"**/logs"：避免扫描生成的报告和日志文件 - 别写
"**/node_modules/**"：多出的/**在 VSCode 中反而可能失效（实测部分版本不识别）
这些规则必须写在工作区根目录的 .vscode/settings.json 中才生效，写在用户级设置里容易被项目级覆盖，写错位置等于没写。
临时限定范围：搜索面板里填 files to exclude
不想改配置？下次搜索立刻生效的办法就是手动填排除路径：
- 打开
Ctrl+Shift+F，点右上角 ⋯ → 展开 “files to exclude” 输入框 - 直接输入：
**/node_modules/**,**/dist/**,**/build/**（英文逗号分隔） - 路径基于工作区根目录，不是当前文件所在路径
- 这个设置只对本次搜索有效，关掉面板就清空，适合查某个子包时临时收紧范围
注意：这里不支持正则，只认 glob；也不能用 ! 前缀（那是终端命令语法），直接写要排除的 pattern 就行。
search.maxFileSize 是隐藏的“深度刹车片”
当某个目录里存在超大文件（比如打包后的 bundle.js、千行 JSON、二进制资源），VSCode 默认跳过内容搜索（但仍会列在结果里显示“文件名匹配”）。这个限制比“目录深度”更实际地阻止了 IO 卡死：
- 默认值是
12800（约 12.5KB），搜不到大文件里的关键词，常被误认为“漏搜” - 在设置中搜
search.maxFileSize，改成5242880（5MB）或0（不限制） - 设为
0要谨慎：如果项目里有几百 MB 的日志或 dump 文件，首次搜索可能卡住几秒
这个设置改完立即生效，不用重启，但得重新触发一次搜索（哪怕删个空格再输回去）。
真正卡住 VSCode 搜索的，从来不是“目录嵌套太深”，而是默认把 node_modules 和 dist 当成普通源码目录去逐个 stat() 和尝试解码。排除路径 + 控制文件大小 + 关闭 search.useIgnoreFiles（避免被 .gitignore 意外过滤），这三招齐下，比找一个不存在的 depth 设置管用得多。
