React项目升级npm依赖后npm install报ERESOLVE错误咨询

这个是npm 7及以上版本默认开启严格peer依赖校验导致的。你这次是跨多个大版本升级依赖：React从17升到18、React Router从5升到6、testing-library相关包从11/12代升到13/14代、react-scripts从4升到5，跨大版本升级时不同包的peer依赖声明更新节奏不一致，加上你删除了package-lock.json后npm会重新解析全量依赖树，校验到版本声明不匹配就会抛出ERESOLVE错误。

• npm i --legacy-peer-deps：这个参数会完全跳过peer依赖校验，沿用npm 6时代的宽松安装逻辑。对你这个全新项目的场景来说风险极低：你升级后的包本身官方都已经适配React 18，报错里的依赖冲突只是部分嵌套依赖还没同步更新peer依赖声明而已，装完后只要能正常启动、构建、跑测试，就不会有运行问题。唯一的潜在隐患是如果后续装新包一直带这个参数，可能会装到和当前核心依赖完全不兼容的包而没有提示，只要装完新包做基础功能验证就能规避。
• npm i --force：这个参数逻辑更激进，会强制覆盖本地已安装的不符合版本要求的依赖，强行拉取远程最新版本解析依赖树。这个的风险比上一个高，可能会把某些嵌套依赖装到不兼容的版本，导致运行时出现奇奇怪怪的报错，不是首选方案。

• 先把本地残留的node_modules文件夹整个删掉，不要只删lock文件，避免旧版本依赖缓存干扰解析
• 优先执行不带参数的npm install，如果还是报peer依赖错误，再加--legacy-peer-deps参数执行即可
• 安装完成后立刻执行npm start、npm run build、npm test三个核心命令，只要都能正常运行，就说明依赖没有实际冲突，后续可以正常开发。

补充：跨大版本升级React相关依赖不要直接用ncu一把全升，尤其是React Router 5到6、react-scripts 4到5都有不少破坏性变更，装完依赖后还要对照官方升级文档调整入口文件、路由配置的代码，不然项目跑起来也会报语法错。

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