为何在子项目目录运行tsc仍检查父目录node_modules？

TypeScript 默认的模块解析机制会向上遍历目录树查找node_modules，包括父目录下的类型定义文件（比如@types），这和根目录tsconfig.json的exclude配置无关——因为你是在子项目目录执行tsc，此时使用的是子项目自己的tsconfig，根目录的配置不会影响子项目的编译行为。父目录的@types/superagent版本可能和子项目依赖的版本不兼容，导致出现Module "buffer" has no exported member 'Blob'这类类型冲突错误。

解决方法： #

• 限制子项目的类型定义查找范围
  在子项目的tsconfig.json中配置typeRoots，指定只使用子项目自身node_modules下的类型定义：

  {
    "compilerOptions": {
      "typeRoots": ["./node_modules/@types"]
    }
  }
  

  这样 TypeScript 会优先从子项目本地的@types目录加载类型，不会再向上查找父目录的类型文件。

• 确保子项目依赖完全独立
  进入子项目目录执行npm install，确保所有依赖（包括对应的@types包）都安装在子项目自己的node_modules里，避免父目录依赖干扰。

• 临时跳过库类型检查（不推荐长期使用）
  如果只是想快速绕过错误，可以在子项目tsconfig.json中开启skipLibCheck：

  {
    "compilerOptions": {
      "skipLibCheck": true
    }
  }
  

  这个选项会跳过所有库文件的类型检查，但可能掩盖真正的类型问题，仅作为临时方案。

内容的提问来源于stack exchange，提问作者user15951701