VS Code中通过npm安装Material-UI出现依赖报错如何解决

npm 7及以上版本默认开启peer依赖严格校验，版本不匹配时会直接终止安装，本次报错的核心冲突为：

• 当前项目已安装的React版本为^18.1.0
• 待安装的@material-ui/core@4.12.4（Material-UI v4稳定版）声明的peer依赖仅支持^16.8.0 || ^17.0.0版本的React，未适配React 18，版本匹配失败。

按优先级从高到低选择对应方案处理即可：

• 方案1（推荐）：安装适配React 18的MUI v5正式版
  Material-UI v4已经停止功能更新，官方后续维护的v5版本原生支持React 18，注意v5的包名已变更，直接执行以下命令安装即可：

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

  如果需要使用Material-UI的图标组件，额外执行npm install @mui/icons-material即可。

• 方案2（临时应急）：跳过peer依赖校验安装v4版本
  如果因为项目历史原因必须使用v4版本的@material-ui/core，安装时加上--legacy-peer-deps参数，让npm使用v6及以前版本的宽松依赖解析逻辑，跳过版本校验：

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

  注意：该方式只是绕过安装校验，v4版本本身未对React 18做适配，后续开发中可能出现组件渲染异常、钩子报错等兼容性问题，不建议在长期维护的项目中使用。报错中提到的--force参数会强制覆盖本地已有依赖，风险更高，非极端情况不要使用。

• 方案3：降级React版本匹配v4要求
  如果必须用v4版本且不想跳过依赖校验，可以把项目内的React、React-DOM降级到v4支持的最高17.x版本，再执行安装：

  npm install react@17.0.2 react-dom@17.0.2
  npm install @material-ui/core
  

内容的提问来源于stack exchange，提问作者Ayush Tawar