Windows系统VSCode中npm安装@material-ui/core报ERESOLVE依赖冲突错误

npm 7及以上版本默认开启严格peer依赖校验，本次安装失败的核心冲突是：

• 当前项目已安装react@18.2.0
• 你要安装的@material-ui/core@4.12.4的peer依赖要求仅支持react@^16.8.0 || ^17.0.0，和React 18版本不匹配，校验不通过直接终止安装。

终端开头提示的--global/--local参数废弃警告属于npm版本配置提示，和本次安装失败无关，不需要额外处理。

• 临时快速修复：安装命令追加--legacy-peer-deps参数，让npm使用v6版本的宽松依赖解析逻辑，跳过严格peer校验：

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

  如果执行后仍报错，可以替换为--force参数强制覆盖冲突依赖安装：

  npm install @material-ui/core --force
  

  注意：这两种方式安装的版本不匹配依赖，可能在项目运行时出现兼容性异常，仅适合本地临时调试场景，生产环境不建议使用。

• 长期稳定方案（官方推荐）：@material-ui/core是Material UI的v4旧版包，已经停止功能迭代，官方后续版本已迁移到@mui命名空间，v5及以上版本原生兼容React 18，直接安装新版即可：
  1. 如果之前尝试安装过旧版包，先执行卸载：

     npm uninstall @material-ui/core
     

  2. 安装React 18兼容的新版Material UI：

     npm install @mui/material @emotion/react @emotion/styled
     

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