如何解决npm安装过程中出现的peer依赖版本冲突问题？

当前冲突根源 #

你项目根目录安装的@typescript-eslint/parser@~4.31.2和@nrwl/eslint-plugin-nx@12.9.0要求的~4.28.3版本不兼容，而eslint-config-next@11.1.2要求的^4.20.0版本覆盖了4.20.0以上的所有4.x版本，不存在冲突，只需解决nx插件和根依赖的版本差即可。

推荐解决方案（按优先级排序） #

方案1：对齐兼容版本（最稳妥） #

~4.28.3同时满足nx插件的版本要求和next配置的版本要求，直接修改根目录package.json中的依赖版本即可：

• 将package.json中@typescript-eslint/parser的版本号改为~4.28.3
• 删除项目下的node_modules文件夹和package-lock.json文件
• 重新执行npm install即可

方案2：强制覆盖peer依赖（适用于必须使用4.31.2版本的场景） #

如果你必须使用@typescript-eslint/parser@4.31.2的相关特性，可以通过npm的overrides配置强制指定依赖版本（需要npm 8.3及以上版本支持）：
在package.json中新增如下配置：

{
  "overrides": {
    "@nrwl/eslint-plugin-nx": {
      "@typescript-eslint/parser": "$@typescript-eslint/parser"
    }
  }
}

配置完成后重新执行npm install即可。注意：该方案会跳过peer依赖校验，安装完成后需要手动测试lint相关功能是否正常运行

方案3：临时绕过校验（仅适合应急场景） #

如果只是临时要安装依赖赶进度，可以直接执行带参数的安装命令，忽略所有peer依赖冲突校验：

npm install --legacy-peer-deps

该方案会沿用npm v6的依赖处理逻辑，不对peer依赖的版本匹配做强制校验，缺点是可能存在隐式的兼容问题，不建议长期使用。

同类冲突通用处理思路 #

• 先从报错信息中梳理所有依赖要求的版本范围，优先选择所有范围的交集版本，兼容性最好
• 没有交集版本时，再通过overrides配置强制指定版本，安装后做对应功能测试
• 应急场景下可使用--legacy-peer-deps参数临时绕过校验

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