VSCode打开tsconfig.json时报找不到'docs'类型定义文件错误

该报错是TS类型扫描逻辑与项目异常配置、错误依赖共同触发的，完整触发链路如下：

• TS 的类型加载规则：当项目配置了typeRoots字段且未手动指定types白名单时，会自动扫描所有typeRoots路径下的一级子目录，将每个子目录都作为隐式类型库尝试加载，哪怕目录内没有有效类型定义，也会抛出对应找不到类型的报错。
• 依赖解析异常：你在dependencies中写入的"@types/": "typegoose/typegoose" 完全不符合npm包命名规范，npm会将该条目识别为@types作用域下的空包名，指向typegoose/typegoose的git仓库地址。安装过程中会在node_modules/@types目录下生成一个失效的docs软链（对应原仓库内的文档目录）。
• 问题复现逻辑：由于没有删除这个错误依赖条目，就算反复删除node_modules重装依赖，npm每次安装都会重新生成这个失效的docs软链，刚好被TS的扫描逻辑捕获，持续触发报错。

• 移除package.json中的无效依赖
  直接删除dependencies里的"@types/": "typegoose/typegoose" 条目。@typegoose/typegoose v7.6.0 本身已内置完整TS类型定义，不需要额外在@types作用域下安装配套类型包，该条目本身属于误配置。
• 清除残留无效结构
  删除错误依赖后重新执行npm install，npm不会再生成失效的docs软链。如果安装完成后node_modules/@types目录下仍残留docs文件夹/软链，手动删除即可。
• 优化tsconfig.json配置规避同类问题
  1. 删掉当前tsconfig中typeRoots配置项末尾的多余尾逗号，避免配置解析异常。
  2. 在compilerOptions中新增types字段，显式声明需要加载的类型库白名单，关闭TS对typeRoots下所有目录的无差别扫描行为，后续就算出现非预期的空目录，也不会触发同类隐式类型加载报错。

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