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/stylednpm 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,提问作者נעמה
相关产品推荐
相关产品推荐

