React 18.2.0安装@material-ui/core时遇依赖树解析失败错误求解决

问题原因 #

@material-ui/core 4.12.4 的 peer 依赖明确要求 React 版本为 ^16.8.0 || ^17.0.0，而你的项目使用的是 React 18.2.0，版本不匹配导致依赖树解析失败。

可行解决方案 #

• 升级到 Material UI v5（推荐长期方案）
  Material UI v5（现命名为 MUI）已完全支持 React 18，是官方推荐的升级方向。操作步骤：

  # 卸载旧版Material-UI
  npm uninstall @material-ui/core
  # 安装MUI v5核心库及依赖样式库
  npm install @mui/material @emotion/react @emotion/styled
  

  注意：v5 与 v4 存在部分 API 差异，需调整组件导入路径（如从 @material-ui/core/Button 改为 @mui/material/Button）及部分组件用法。

• 使用 --legacy-peer-deps 强制安装（临时过渡方案）
  若暂时无法升级到 v5，可通过忽略 peer 依赖冲突完成安装：

  npm install @material-ui/core --legacy-peer-deps
  

  注意：此方式可能引发潜在兼容性问题（如部分组件在 React 18 下运行异常），仅建议作为临时过渡使用。

• 降级 React 到 17.x 版本
  若项目未依赖 React 18 的新特性，可降级 React 以满足旧版 Material-UI 的依赖要求：

  # 降级React及ReactDOM到17.x
  npm install react@^17.0.0 react-dom@^17.0.0
  # 重新安装@material-ui/core
  npm install @material-ui/core
  

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