VSCode报“检测到递归路径”本质是路径扫描误判，主因包括软链接指向工作区内路径、files.watcherExclude配置冲突或多根工作区folders存在隐式父子关系，需检查符号链接目标、精简排除规则及调整工作区结构。
VSCode 报错“检测到递归路径”，本质不是文件系统真递归，而是它在扫描工作区时发现某个目录被多次纳入——比如软链接指向父目录、符号链接形成环、或 files.watcherExclude / search.exclude 配置不当触发误判。直接删链接或关监听不解决问题，得从 VSCode 如何解析路径层级入手。
检查 workspaceFolder 是否包含符号链接环
VSCode 在启动资源管理器时会对每个 workspaceFolder 做深度遍历，若其中任一子目录是软链接且最终指向该工作区内部（例如 libs → ../src/libs），就会触发“检测到递归路径”警告并跳过整个分支。
- 在终端中运行
find . -type l -exec ls -la {} \;，查看所有软链接目标是否落在当前工作区路径内 - 特别注意
node_modules、dist、build下的链接，某些构建工具（如 pnpm）会生成跨目录硬链接，VSCode 也会误读为递归 - 临时修复：用
rm -f libs删除可疑链接，改用相对路径导入或调整构建配置
验证 files.watcherExclude 是否引发路径重叠
files.watcherExclude 本意是减少文件监听开销，但若正则写得太宽（如 "**/src/**"），VSCode 可能因路径匹配逻辑缺陷，把排除规则反向应用到父级扫描路径上，造成“已排除路径又被纳入”的假递归信号。
- 打开
settings.json，搜索files.watcherExclude，确认没有类似"**/node_modules/**"和"**/node_modules"同时存在（重复排除会干扰路径树构建） - 禁用该配置后重启 VSCode，观察警告是否消失；若消失，说明是排除规则冲突而非真实递归
- 安全写法：只保留一层通配，如
"**/node_modules": true，不要加尾部/**
多根工作区下 folders 数组顺序导致的隐式嵌套
当使用 .code-workspace 文件定义多根工作区时，VSCode 会按 folders 数组顺序逐个加载。如果数组里先写了 project/，又写了 project/backend，后者会被视为前者的子路径——即使物理上是独立目录，VSCode 仍可能报递归路径。
- 打开
.code-workspace，检查"folders"数组是否含父子关系路径 - 删除子路径项（如
project/backend），改用单根工作区 + 多文件夹标签页方式管理 - 若必须保留多根，确保所有路径互不为前缀：用绝对路径写全，避免
./backend和./共存
真正麻烦的不是报错本身，而是它常掩盖更底层的问题：比如某次 git checkout 残留了坏链接，或 CI 脚本自动生成的符号链接未清理。每次看到这个提示，优先查 ls -la 输出里的箭头，而不是急着调设置。
