安装@ramonak/react-excel报ERESOLVE依赖冲突错误如何解决？

错误原因 #

该报错属于peer依赖版本不匹配问题：你当前项目运行的React版本为17.0.2，但要安装的@ramonak/react-excel@1.0.1声明的对等依赖仅支持^16.0.0版本的React（即16.x全系列）。npm v7及以上版本默认会严格校验peer依赖的版本兼容性，因此直接终止了安装流程。

解决方案 #

方案1：跳过peer依赖校验安装（改动最小，优先尝试） #

直接在原有安装命令后添加--legacy-peer-deps参数即可：

npm install --save @ramonak/react-excel --legacy-peer-deps

该参数会让npm沿用v6版本的依赖解析逻辑，忽略本次peer依赖版本不匹配的问题直接安装。绝大多数React16组件都可以在React17环境下正常运行，只要后续测试组件功能无异常，该方案成本最低。

如果执行后依旧报错，可以追加--force参数强制安装：

npm install --save @ramonak/react-excel --legacy-peer-deps --force

方案2：降级项目React版本到16.x系列 #

如果担心跳过校验会存在潜在的兼容问题，可以将项目的React版本降至组件支持的16.x系列：

1. 卸载当前版本的React相关包

npm uninstall react react-dom

2. 安装16.x版本的React

npm install --save react@^16.14.0 react-dom@^16.14.0

3. 正常安装目标组件

npm install --save @ramonak/react-excel

方案3：替换为支持高版本React的同类组件 #

如果上述两个方案都不符合项目要求，可以选择其他支持React17及以上版本的Excel编辑组件，比如搭配xlsx库和自定义表格组件实现同等功能。

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