yarn安装react-query失败提示@tanstack/react-query未找到如何解决

1. 先解决包管理器混用问题 #

项目中同时存在npm生成的package-lock.json和yarn的锁文件，会直接导致依赖解析逻辑异常，先统一包管理器：

• 选定用yarn的话，直接删除项目根目录下的package-lock.json
• 后续打算用npm的话，删除yarn.lock，后续所有依赖操作统一用npm命令，不要交叉执行yarn和npm指令

清理锁文件后建议同时删除现有node_modules目录，避免旧依赖缓存干扰，命令行执行rm -rf node_modules即可，Windows系统可手动删除该文件夹或执行rd /s /q node_modules

2. 校验安装包名正确性 #

react-query版本迭代后包名有变更，不要写错包名：

• v4及以上最新版本包名为@tanstack/react-query，安装命令为yarn add @tanstack/react-query
• v3及更早历史版本包名为react-query，如果要兼容旧项目安装旧版本，执行yarn add react-query@3
  注意检查安装命令有没有打错字符、多余空格或者拼写错误。

3. 修复yarn镜像源配置 #

包名无误仍报资源不存在，基本是本地yarn配置的镜像源异常导致的：

• 先执行yarn config get registry查看当前配置的源地址，如果地址无效、是过期的私有源/镜像站，先重置为官方源测试：yarn config set registry https://registry.yarnpkg.com/
• 如果官方源访问速度慢、连接超时，可以替换为稳定的国内镜像源：yarn config set registry https://registry.npmmirror.com/
• 源配置完成后先清空本地yarn缓存：yarn cache clean，再重新执行安装命令即可。

4. 特殊场景排查 #

• 如果是公司内网项目，检查项目根目录下的.yarnrc、.npmrc配置文件，确认没有把@tanstack作用域的包单独指向不可用的私有源地址，如果有相关规则需要调整，给该作用域单独配置公共源。
• 检查本地网络代理配置是否异常，比如代理规则拦截了包请求、代理过期失效，可以暂时关闭代理后重试安装。

内容的提问来源于stack exchange，提问作者Amirul Islam Hridoy