npm install执行失败（ERESOLVE错误）：依赖冲突求助

错误根源 #

• 核心冲突：当前项目使用react@18.2.0，但依赖radium@0.26.2的peer依赖要求仅支持react@^16.8.0 || ^17.0.0，版本不兼容导致npm无法自动解析依赖树，抛出ERESOLVE错误。
• 额外说明：你的package.json中未显式声明radium依赖，但错误日志显示它是项目直接依赖，大概率是之前安装后未从package.json移除，或安装时未添加--save参数导致依赖记录丢失。

解决方法 #

1. 移除无用的Radium（优先推荐） #

如果项目实际不需要Radium，直接卸载：

npm uninstall radium

执行后重新运行npm install即可正常安装依赖。

2. 降级React到兼容版本 #

若必须使用Radium，将React和ReactDOM降级至17.x版本：

• 修改package.json中的依赖版本：

"dependencies": {
  "react": "^17.0.2",
  "react-dom": "^17.0.2",
  "react-icons": "^4.10.1",
  "react-typed": "^1.2.0"
}

• 删除现有依赖文件并重新安装：

rm -rf node_modules package-lock.json
npm install

3. 忽略peer依赖冲突（临时方案） #

希望保留React 18同时强行安装的话，使用--legacy-peer-deps参数绕过冲突检查：

npm install --legacy-peer-deps

⚠️ 注意：此方法可能导致Radium在React 18环境下运行异常，因为Radium未适配React 18的API，兼容性问题风险高。

4. 升级Radium到兼容版本（若可用） #

检查Radium最新版本是否已支持React 18，若有则安装最新版：

npm install radium@latest

（注：截至目前Radium稳定版仍为0.26.2，暂无React 18适配版本，此方法暂不可用）

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