React-query & TypeScript：无法找到@tanstack/react-query模块或类型声明

以下是针对问题的具体排查和解决步骤：

• 确认依赖正确安装
  打开项目根目录的package.json，检查dependencies中是否存在@tanstack/react-query，且版本为v4.x.x。如果没有，重新执行安装命令并确保过程无报错：

  yarn add @tanstack/react-query
  

  若安装时有网络问题，可尝试切换源后重新安装。

• 升级TypeScript版本
  TanStack Query v4要求TypeScript版本≥4.7。执行以下命令查看当前版本：

  tsc --version
  

  若版本低于4.7，升级TypeScript：

  yarn add typescript@^4.7 --dev
  

• 调整tsconfig.json配置
  打开tsconfig.json，检查compilerOptions：

  • 确保moduleResolution设置为node16、nodenext或node（推荐node16以适配ES模块）；
  • 若配置了baseUrl或paths，确认它们没有干扰@tanstack/react-query的路径解析。

• 清除TypeScript缓存
  执行命令清除TS缓存：

  yarn tsc --clearCache
  

  同时删除项目根目录下的.tsbuildinfo文件（如果存在），之后重启你的代码编辑器（如VS Code）。

• 切换编辑器的TypeScript版本
  以VS Code为例：按Ctrl+Shift+P（Mac为Cmd+Shift+P），输入TypeScript: Select TypeScript Version，选择Use Workspace Version，确保使用项目本地安装的TS版本而非全局旧版本。

• 移除冲突的@types包
  TanStack Query v4自带类型声明，无需额外安装@types/react-query（这是v3的类型包）。检查package.json的devDependencies，若存在@types/react-query，执行命令删除：

  yarn remove @types/react-query
  

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