接手新项目,安装依赖报错

Daotin 于 2024-04-01 发布 编辑

问题:

接手的新项目在使用 npm i 安装依赖的时候,提示:

While resolving: @vue/compiler-sfc@3.0.11 npm ERR! Found: vue@2.6.12

分析:

ChatGPT 给出的理由是,

  1. 项目中已安装的是 Vue 2.6.12,但你正在尝试安装需要 Vue 3.0.11 的依赖(如 @vue/compiler-sfc@3.0.11)。
  2. 这导致了一个无法解决的依赖冲突,因为 Vue 3.x 的版本与 Vue 2.x 版本不兼容。

尝试过程:

  1. 加入 npm install –legacy-peer-deps 选项,依然报错。
在使用 `npm i --legacy-peer-deps` 命令时,`--legacy-peer-deps` 参数的作用是告诉 npm 在安装依赖时忽略对等依赖(peer dependencies)的版本检查。这个参数通常用于解决在安装包时出现对等依赖版本不匹配导致安装失败的问题。

举个例子,假设你正在尝试安装一个名为 `package-A` 的包,它依赖于 `package-B` 和 `package-C`,而 `package-B` 和 `package-C` 都声明了对同一个包 `package-D` 的对等依赖,但分别要求不同版本的 `package-D`。在这种情况下,如果版本冲突,npm 默认会抛出错误并拒绝安装,因为对等依赖的版本不兼容。

通过使用 `npm i --legacy-peer-deps`,你告诉 npm 在安装 `package-A` 时忽略对等依赖的版本检查,这样就可以绕过版本冲突的问题,强制安装 `package-A`,即使它的对等依赖版本与当前项目中已安装的版本不兼容。这样可能会导致一些潜在的兼容性问题,因此应该谨慎使用,并在安装后测试确保一切正常运行。
  1. @vue/compiler-sfc 降级到 2 版本,依然安装报错

解决:把 package-lock.json 删除后,安装成功。

遇到问题:使用淘宝镜像源安装成功后,serve 启动失败。

继续解决:删除 lock 和 node_modules 文件,然后 npm cache clean —force 文件。镜像源切换成 npm 再次安装,启动成功。

怀疑是因为 node 版本不同,所以对应的 lock 文件会有影响。