React项目出现“could not find declaration file for module ...”错误求助

报错1：Module not found但模块实际存在于node_modules #

原因 #

npm和yarn的依赖扁平化规则、锁文件解析逻辑存在差异，加上Node版本升级后原有依赖的二进制包兼容性问题，会导致依赖树结构不符合预期，即使模块存在也无法被正常解析。

解决步骤 #

• 删除残留的依赖文件和锁文件：

  # macOS/Linux
  rm -rf node_modules package-lock.json yarn.lock
  # Windows
  rmdir /s /q node_modules && del package-lock.json yarn.lock
  

• 清理yarn本地缓存，避免复用旧版本不兼容的依赖包：
  yarn cache clean
• 重新执行依赖安装：
  yarn install
• 若仍有报错，检查打包工具（如webpack）的resolve配置，确认配置了.js、.json等默认扩展名，没有错误的别名配置指向不存在的路径。

报错2：提示找不到TypeScript声明文件但项目未接入TS #

原因 #

第三方依赖自带类型声明文件、项目意外安装了TS相关依赖、打包工具默认开启了TS类型检测，都会触发该报错，和项目本身是否写TS代码无关。

解决步骤 #

• 检查package.json的devDependencies字段，卸载意外引入的typescript、ts-loader、@types/*相关依赖。
• 检查打包工具配置：若使用webpack，确认module.rules中没有对.js文件应用ts-loader的规则，resolve.extensions中.js扩展名的优先级高于.ts/.tsx。
• 若使用官方脚手架（如create-react-app），可在项目根目录新增空的tsconfig.json文件，或在package.json中新增"types": []配置，关闭全局类型自动搜索。
• 也可以在安装依赖时添加参数跳过可选的类型依赖安装：
  yarn install --ignore-optional

内容的提问来源于stack exchange，提问作者Mohan Krishna Sai