批量更新package.json依赖后yarn可安装但npm install报错原因

为什么npm install会报错？ #

核心是依赖版本冲突，再加上npm和yarn对peer依赖的校验策略不同：

1. 执行npx npm-check-updates -u后，package.json里的react被升级到了18.2.0，但你的项目依赖的@material-ui/core@4.12.4仅支持react 16.8.0~17.x版本，两者不兼容。
2. npm从v7版本开始默认严格校验peer依赖，一旦发现依赖不满足要求就直接抛出错误；而yarn（尤其是v1版本）对peer依赖的校验规则更宽松，会自动忽略这类冲突完成安装，但实际上项目可能存在运行时风险。

解决办法 #

• 降级react版本：把package.json里react的版本改为^17.0.0，重新执行npm install，即可满足@material-ui/core的peer依赖要求。
• 跳过peer依赖校验：执行npm install --legacy-peer-deps或者npm install --force，强制npm忽略依赖冲突完成安装，但这种方式可能导致项目运行时出现兼容性问题，需谨慎使用。
• 升级UI库版本：@material-ui/core v4不支持react18，你可以升级到MUI v5（包名改为@mui/material），它完全兼容react18，不过需要调整项目里的相关组件导入代码。

内容的提问来源于stack exchange，提问作者TO YUU