记录一次切换包管理器引发的血案

发布时间：2025-11-04 20:19:29 来源：云智核 作者：应用开发

我们现在的记录项目统一用 yarn 进行包管理，之前有一个旧项目之前使用的次切是 npm 进行管理。于是换包我决定切换一下。

我具体的管理做法简单粗暴，直接 yarn install。器引

结果我发现之前还好好的血案项目，突然就出现各种问题，记录其中一个问题是次切 ANTD 的图标重复渲染了，显示出来两个。换包

经过一轮搜索，管理我找到一个 ISSUE，器引看起来是血案版本发生了一些变更。

这...估计是记录我切换包管理器导致的。

我们项目依赖 antd 的次切版本是 3.2.2，另外一个库 json-schema-editor-visual 依赖于 ntd@^3.1.6。换包

在 package-lock.json 中，两个 antd 的版本合成了一个，最后只安装了 3.2.2​ 的版本。这是云南idc服务商因为 json-schema-editor-visual 中使用了 ^3.1.6，并没有锁次版本，所以它直接跟外面的同时下载一个版本。

回顾以下基础知识，npm 的版本锁定的规则如下：

但是在使用 yarn install 之后，发现 json-schema-editor-visual 还是安装了一个 antd@3.1.6 的版本，导致了出现版本不一致导致的源码下载问题。

图示如下所示：

使用 yarn import。

该命令是 yarn 帮助迁移当前所依赖的项目的 package-lock.json，尽可能减少锁文件和现有依赖树之间的差异。

在执行这个时候，还发现了一个报错。

这个问题，我一直认为是 node 版本的问题，结果切换 node 版本一直没法解决，最后还是 Google 帮我解决了问题。从这个 issue 中我找到了答案。

最后我手动修改了 package-lock.json 中的 upath 的版本为 ^1.0.5。

执行 yarn import。终于成功了，泪目。

虽然上面只提到了 antd 的版本不一致导致的问题，实际上还有其他的问题也是由于版本不一致导致的。所以我们在切换包管理的时候，源码库尽可能的保持包版本一致。

一般可以使用官方提供的命令，比如 yarn 的 yarn import​，还有 pnpm 提供的，pnpm import 来处理是最恰当的。

相关文章