安装npm包时遇Peer依赖冲突错误，求解决方案

错误核心原因 #

你的项目当前安装的react@17.0.2，与react-native@0.71.3要求的peer依赖react@18.2.0存在版本冲突，而react-native-webview同时依赖这两个包，导致npm无法解析出合法的依赖树。

可行解决方案 #

方案1：升级React到兼容版本

react-native@0.71.x 官方要求搭配react@18.2.0，直接升级核心依赖：

# 升级react和react-dom到指定版本
npm install react@18.2.0 react-dom@18.2.0 --save

# 清理旧依赖后重装
rm -rf node_modules package-lock.json
npm install

方案2：降级React Native到适配React 17的版本

如果不想升级React，将react-native降级到支持react@17的版本（比如0.69.x系列）：

# 降级react-native
npm install react-native@0.69.9 --save

# 同步降级react-native-webview到适配版本
npm install react-native-webview@11.23.1 --save

# 清理后重装依赖
rm -rf node_modules package-lock.json
npm install

方案3：锁定版本范围避免自动升级

检查你的package.json，确保核心依赖的版本范围不会拉取不兼容版本：

• 将react的版本从^17.0.1改为17.0.2（锁定小版本）或^18.2.0（兼容大版本）
• 将react-native的版本从模糊范围改为明确的兼容版本号
• 调整后执行清理重装操作

注意事项 #

--legacy-peer-deps无法解决这类直接的核心版本冲突，强行忽略可能导致运行时出现组件渲染错误、API不兼容等问题，优先通过版本适配解决是更稳妥的方式。

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