执行npm install遇ERESOLVE依赖冲突：原因及解决方法

这是典型的peer依赖版本冲突问题：

• 项目当前安装的是webpack@4.46.0，但项目依赖的browser-sync-webpack-plugin@2.0.1对peer依赖的要求是webpack@^1 || ^2 || ^3，两者版本范围不重叠，npm的依赖解析器（ERESOLVE）无法自动调和这个冲突，因此抛出错误。

以下是几种可行的解决方案，按推荐程度排序：

1. 使用--legacy-peer-deps参数安装 #

直接执行以下命令，让npm采用旧版（npm v6）的peer依赖解析逻辑，忽略版本冲突：

npm install --legacy-peer-deps

这是最快捷的解决方式，适合快速推进开发，但需注意后续可能存在潜在的兼容性风险，建议后续跟进插件版本升级。

2. 升级browser-sync-webpack-plugin到兼容webpack4的版本 #

browser-sync-webpack-plugin的v3.x及以上版本已经支持webpack4，修改项目package.json中的依赖配置：
将"browser-sync-webpack-plugin": "2.0.1"替换为"browser-sync-webpack-plugin": "^3.0.0"（可根据需求选择最新兼容版本），然后重新执行：

npm install

这种方式从根源解决版本冲突，是最稳妥的方案。

3. 谨慎使用--force参数强制安装 #

执行以下命令强制npm安装依赖，即使存在冲突：

npm install --force

该方式会强制生成依赖树，但可能导致项目运行时出现未知报错，仅在紧急情况下临时使用。

4. 降级webpack到3.x版本（不推荐） #

若坚持使用旧版插件，可将webpack降级到3.x版本，但这会导致@vue/cli-service等其他依赖的peer依赖不满足，引发更多连锁冲突，因此不建议采用。

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