更新后如何解决「Conflicting Peer Dependencies」依赖冲突错误
2026-8-7
解决方案
首先明确核心问题：你的项目中当前react@18.1.0与react-dom@18.2.0的peer依赖版本不匹配，导致npm安装yarn时触发依赖解析失败。以下是分步解决办法：
1. 先绕过冲突安装yarn
这是快速解决当前yarn安装失败的办法，直接用npm的兼容模式：
npm install yarn --legacy-peer-deps
如果仍报错，使用强制模式：
npm install yarn --force
2. 修复react版本冲突
安装完yarn后，建议统一react和react-dom的版本，避免后续依赖问题：
yarn add react@18.2.0 react-dom@18.2.0 --save
如果习惯用npm操作：
npm install react@18.2.0 react-dom@18.2.0 --save
3. 彻底清理依赖重新安装
若上述方法无效，尝试完全重置依赖环境：
- 删除本地依赖包：
rm -rf node_modules - 删除npm锁文件：
rm package-lock.json - 清理npm缓存：
npm cache clean --force - 再次安装yarn：
npm install yarn --legacy-peer-deps - 用yarn重新安装项目依赖：
yarn install
是否需要新建项目？
除非上述所有方案都彻底失败，否则不建议新建项目——新建项目需要重新迁移业务代码、配置路由与组件，耗时且没必要。优先尝试上述步骤，基本能解决依赖冲突问题。
内容的提问来源于stack exchange，提问作者Rémi-Antoine Joron
相关产品推荐
相关产品推荐
