React报@material-ui/core模块找不到、安装依赖冲突如何解决

安装失败的核心原因是旧版Material UI v4（npm包名前缀为@material-ui/）仅声明支持React 16.8+、React 17版本，和当前项目使用的React 18.1.0存在peer依赖版本冲突，npm v7及以上版本默认开启严格依赖树校验，会直接阻断不符合版本要求的安装流程。
安装过程中出现的--global/--local废弃警告是npm自身的版本提示，和本次依赖安装失败无关，可暂时忽略。

Material UI 从v5版本开始正式适配React 18，包名前缀更新为@mui/，是适配当前React版本的官方标准方案，操作步骤如下：

• 先清理之前安装失败产生的残留依赖：
  npm uninstall @material-ui/core @material-ui/icons
• 安装适配React 18的MUI v5核心组件、图标包及必需的样式依赖：
  npm install @mui/material @mui/icons-material @emotion/react @emotion/styled
• 批量替换代码中的导入路径：将所有@material-ui/core/开头的导入替换为@mui/material/，@material-ui/icons开头的导入替换为@mui/icons-material/即可。MUI v5对v4的组件API保持了大部分兼容，仅少量边缘属性需要调整，改造成本极低。

如果项目中已经存在大量基于Material UI v4编写的代码，暂时不想做版本升级，可以通过绕过npm严格peer依赖校验的方式强制安装：
npm install @material-ui/core @material-ui/icons --legacy-peer-deps

注意：该方案本质是跳过版本检查强制安装，v4版本的Material UI未针对React 18的并发特性做适配，部分依赖DOM生命周期的组件（如Modal、Autocomplete、Tooltip等）可能出现运行时异常，仅适合本地临时调试使用。

如果需要消除npm的--global废弃警告，后续执行全局包安装时，将--global/-g参数替换为--location=global即可。

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