TL;DR:
- NPM v7+ 安装peerDependency默认情况下 https://github.com/npm/rfcs/blob/main/implemented/0025-install-peer-deps.md;这是not以前版本的 NPM 的情况也是如此。
- NPM 模块必须命名具体版本他们的peerDependency
- 如果您已经安装了peerDependency,但没有使用该模块命名的版本,那么NPM v7+将抛出错误
- Adding
--legacy-peer-deps
忽略这一新要求,冒着引入重大变更的风险
--legacy-peer-deps 从 NPM v4 到 v6 恢复peerDependency安装行为
思考这个标志的一种方式是,它并不是在做新的事情;而是在做一些新的事情。相反,它告诉 NPMnot从 NPM v7 开始做一些新的事情现在默认安装peerDependency.
在许多情况下,这会导致版本冲突,从而破坏安装过程。
The --legacy-peer-deps
v7 中引入了 flag 作为绕过 peerDependency 自动安装的方法;它告诉 NPM 忽略对等部门并继续安装。这就是 NPM v4 到 v6 的过去情况。
如果您不清楚常规部门和同行部门之间的区别,这里有一些背景信息:
依赖关系与对等依赖关系
依赖项:NPM 模块所需的库或模块为了在生产中工作。 (示例:我最近构建了一个饼图模拟库,它使用机会.js https://chancejs.com/计算指定范围内的随机数;因此机会是一个依赖性我的模块。)
对等依赖关系:对等依赖是特定版本或版本集第三方软件库的一个模块被设计为与。它们在概念上类似于浏览器扩展和浏览器之间的关系。 (例子:反应还原 https://react-redux.js.org/有两个非常合乎逻辑的peerDependency:react
and redux
.)
此问题部分是由 React v17+ 驱动的
由于大量模块没有专门添加 React v17(或者最近的 React 18)作为 PeerDependency,现在遇到以下情况是很常见的:unable to resolve dependency tree
在 v17 React 应用程序中运行 npm install 时出错。
每当模块(或其任何自己的依赖项)将 React 的先前主要版本列为对等依赖项而不使用此错误时,就会触发此错误具体包括也反应 v17。
(Note:任何其他框架或库的主要版本更新都会发生类似的行为。)
如何检查任何给定模块的对等依赖关系
NPM 本身不会在给定模块的页面上列出对等依赖项。但是,有一个简单的解决方法可以在安装之前或之后检查对等依赖项。只需运行:
npm info name-of-module peerDependencies
此命令将返回每个peerDependency 的名称以及所有兼容版本。