TypeScript项目用Cheerio编译报TS2307错误求解决方案

• 卸载冲突的@types依赖：cheerio 1.x版本已内置类型声明，无需额外安装@types/cheerio，旧版本的@types包会和内置类型冲突，执行命令：

  npm uninstall @types/cheerio
  

• 清理依赖缓存避免残留问题：

  npm cache clean --force
  

• 重新安装cheerio确保依赖完整性：

  npm install cheerio@^1.0.0-rc.12
  

• 检查tsconfig.json的模块解析配置，确保moduleResolution设置为node或nodenext（适配ESM模块），示例配置：

  {
    "compilerOptions": {
      "moduleResolution": "node",
      "target": "ES2020",
      "module": "ESNext"
    }
  }
  

• 重新执行tsc编译，报错即可解决。

问题原因 #

cheerio 1.x版本开始已将类型声明集成在包内，不再依赖第三方@types/cheerio。你安装的@types/cheerio@0.22.31是针对旧版cheerio（0.22.x）的类型定义，与新版cheerio的内置类型产生冲突，导致编译时出现模块导入错误。

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