无法导入@tanstack/react-query相关模块，报错找不到模块

核心原因 #

你遇到的Module not found错误不是TypeScript类型声明问题，而是依赖包未安装或安装路径有误——在react-app-env.d.ts里手动声明模块仅用于解决类型提示问题，无法解决包本身不存在的情况。

解决步骤 #

1. 安装对应依赖包
   你使用的是v4+版本的@tanstack/react-query，对应的开发者工具包也是@tanstack/react-query-devtools，需确保两个包都已安装：

   # 使用npm安装
   npm install @tanstack/react-query @tanstack/react-query-devtools
   # 或使用yarn
   yarn add @tanstack/react-query @tanstack/react-query-devtools
   # 或使用pnpm
   pnpm add @tanstack/react-query @tanstack/react-query-devtools
   

2. 移除多余的类型声明
   @tanstack/react-query和@tanstack/react-query-devtools本身已包含官方TypeScript类型定义，无需手动声明，直接删除react-app-env.d.ts里的这两行：

   declare module '@tanstack/react-query'
   declare module '@tanstack/react-query-devtools'
   

3. 重启开发服务器
   依赖安装完成后，重启React开发服务器，确保新依赖被正确加载。

4. 核对导入路径
   确认导入语句的包名和安装的完全一致——v4+版本包名为@tanstack/react-query，不要和旧版react-query混淆。

额外排查方案 #

• 检查package.json的dependencies字段，确认两个依赖已存在，验证安装是否成功。
• 若仍报错，清理缓存后重新安装：

  # npm环境
  rm -rf node_modules package-lock.json
  npm install
  # yarn环境
  rm -rf node_modules yarn.lock
  yarn install
  

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