现有Vue.js项目安装Vue Router遭遇ERESOLVE依赖树解析错误

问题原因 #

你的项目当前使用Vue 2.7.16，但尝试安装的Vue Router 4.4.0仅兼容Vue 3.2.0及以上版本，版本不匹配导致依赖树解析失败。

解决方案 #

• 安装适配Vue 2的Vue Router版本
  执行以下命令安装专为Vue 2设计的Vue Router 3.x版本：

  npm install vue-router@3
  

• 升级Vue到3.x后安装Vue Router 4.x
  若计划升级项目到Vue 3，先升级Vue：

  npm install vue@latest
  

  再安装最新版Vue Router：

  npm install vue-router@latest
  

不推荐的临时方案 #

错误提示中的--force或--legacy-peer-deps参数可强制跳过依赖检查，但可能引发运行时兼容性问题，仅建议临时测试场景使用：

npm install vue-router --force
# 或
npm install vue-router --legacy-peer-deps

原始错误信息 #

npm error code ERESOLVE
npm error ERESOLVE 无法解析依赖树
npm error
npm error 解析过程中：cutify-web-app@0.1.0
npm error 已发现：vue@2.7.16
npm error node_modules/vue
npm error vue@"^2.6.14" 来自根项目
npm error
npm error 无法解析依赖项：
npm error vue-router@4.4.0 的 peer vue@"^3.2.0"
npm error node_modules/vue-router
npm error
npm error 修复上游依赖冲突，或使用 --force 或 --legacy-peer-deps 参数重新执行命令
npm error 以接受不正确（且可能存在问题）的依赖解析结果。
npm error
npm error
npm error 完整报告请查看：
npm error C:\Users\Phanz\AppData\Local\npm-cache_logs\2024-07-02T15_22_07_936Z-eresolve-report.txt
npm error 本次运行的完整日志可在以下路径找到：C:\Users\Phanz\AppData\Local\npm-cache_logs\2024-07-02T15_22_07_936Z-debug-0.log

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