npm安装react-draft-wysiwyg报ERESOLVE依赖解析失败错误如何解决

问题原因 #

执行npm i react-draft-wysiwyg抛出依赖解析失败错误，核心是版本匹配问题：

• 当前项目使用react@18.2.0版本
• 最新稳定版react-draft-wysiwyg@1.14.7声明的peer依赖仅支持React 0.13~17版本
• npm 7+版本默认严格校验peer依赖合法性，检测到版本不匹配就会终止安装，抛出ERESOLVE错误码

可用解决方案 #

按推荐优先级排序：

• 方案1：安装官方适配React18的版本（生产环境首选）
  react-draft-wysiwyg官方已经发布适配React18的2.0 alpha版本，核心API和1.x稳定版完全一致，不需要修改业务代码，直接执行安装命令即可：

  npm i react-draft-wysiwyg@alpha draft-js
  

  TypeScript项目额外安装类型依赖：

  npm i @types/draft-js @types/react-draft-wysiwyg -D
  

• 方案2：临时绕过peer依赖校验（本地调试用）
  仅做本地功能验证时，可在安装命令后追加--legacy-peer-deps参数，让npm使用v6及以前的宽松依赖解析逻辑，忽略版本冲突强制安装：

  npm i react-draft-wysiwyg --legacy-peer-deps
  

  风险提示：该方案没有做过React18兼容性适配，极端场景下可能出现编辑器渲染异常、状态不同步等问题，禁止在生产环境使用。
  要永久生效该配置，可在项目根目录新建.npmrc文件，写入以下配置：

  legacy-peer-deps=true
  

• 方案3：替换为原生兼容React18的富文本组件（长期维护项目用）
  如果对版本稳定性要求高，可替换为其他原生支持React18、维护活跃的Draft.js生态富文本编辑器，这类组件普遍适配了React18的新特性，不会出现依赖冲突问题，长期维护成本更低。

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