You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Material UI v4与React 18不兼容致安装失败,求解决方案

解决React 18与@material-ui/core@4.x的依赖冲突问题

方案1:升级到支持React 18的MUI 5版本

@material-ui/core的4.x版本本身不兼容React 18,官方已将Material UI迭代至MUI 5版本,该版本完全支持React 18,且包名更新为@mui/material,这是最推荐的解决方案:

  • 卸载旧版依赖:
    npm uninstall @material-ui/core
    
  • 安装MUI 5核心包及必要依赖:
    npm install @mui/material @emotion/react @emotion/styled
    
    若需使用图标组件,额外安装图标包:
    npm install @mui/icons-material
    

方案2:降级React到17.x版本

如果暂时不想升级MUI版本,可以将React降级至17.x,匹配@material-ui/core@4.x的peer依赖要求:

  • 卸载当前React及ReactDOM:
    npm uninstall react react-dom
    
  • 安装React 17.x指定版本:
    npm install react@^17.0.0 react-dom@^17.0.0
    
  • 重新安装@material-ui/core:
    npm install @material-ui/core
    

方案3:使用--legacy-peer-deps参数跳过依赖检查

若不想降级React也不想升级MUI,可使用npm的--legacy-peer-deps参数跳过peer依赖校验,该参数比--force更温和,不会强制覆盖现有依赖:

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

注意:此方式可能引发潜在兼容性问题,部分组件在React 18环境下可能出现异常,需自行测试验证。


内容的提问来源于stack exchange,提问作者נעמה

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.12 15:24:52