如何解决TypeScript错误TS2688：找不到'docs'类型定义文件

以下是针对该错误的具体排查和解决步骤：

• 检查依赖中的隐式引入
  运行以下命令查看项目中是否直接或间接安装了@types/docs包：

  npm ls @types/docs
  # 或使用yarn
  yarn list @types/docs
  

  如果发现存在该依赖，直接卸载它：

  npm uninstall @types/docs --save-dev
  # 或
  yarn remove @types/docs --dev
  

• 清理TypeScript缓存
  TypeScript的缓存可能保留了无效的类型信息，执行以下操作：

  1. 删除项目中的.tsbuildinfo文件（如果存在）
  2. 清除构建工具缓存（如Webpack/Vite的node_modules/.cache目录）
  3. 重新执行编译命令

• 修正typeRoots配置
  你的tsconfig.json中typeRoots包含了node_modules/reflect-metadata，这不是标准的类型定义包目录，可能导致TypeScript误识别类型入口。修改为：

  "typeRoots": ["node_modules/@types", "src/@types"]
  

• 限制自动引入的类型包
  在compilerOptions中添加"types": []，强制TypeScript只引入你显式指定的类型包，避免自动扫描并尝试引入不知名的类型库：

  "compilerOptions": {
    // ...其他配置
    "types": []
  }
  

• 排查项目内的命名冲突
  检查项目中是否存在名为docs的目录，其中包含.d.ts文件但配置异常；或者是否有代码中错误地import了'docs'（而非具体文件路径），导致TypeScript将其解析为类型库。

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