Node 模块中的 peerDependencies 是什么?

一、peer 的含义

//
// peer - a person who is equal to another ,
//        in abilities, qualifications, age, background, and social status.
//
// peer:  同一资格辈分的人(同辈人、同代人)
//

二、正文

在某些 package.json 文件中,你可能见到过一些这样的配置行:

{
  //...
  "peerDependencies": {
    "libraryName": "1.x"
  }
}

dependencies 及 devDependencies 常见,而 peerDependencies 并不是。

  • dependencies 是你的项目所依赖的包。
  • devDependencies 是开发阶段所需要的包。比如说像 Jest 这样的测试框架或 Babel、ESLint 等其他库。

在以上两种情况中,当你安装一个包时,其 dependencies 和 devDependencies 会被 npm 自动安装。

peerDependencies 则有所不同,它们不会被自动安装
当一个依赖项 c 被列在某个包 b 的 peerDependency 中时,它就不会被自动安装。
取而代之的是,包含了 b 包的代码库 a 则必须将对应的依赖项 c 包含为其依赖。
如果运行 npm install 时找不到该依赖,npm 会作出警告,正如例子中所示:

// a/package.json

{
  //...
  "dependencies": {
    "b": "1.x"
  }
}

// b/package.json

{
  //...
  "peerDependencies": {
    "c": "1.x"
  }
}

因此,在包 a 中,必须添加 c 作为一个依赖项,这样当你安装 b 包时,npm 就不会告警了(代码运行时也不会失败):

// a/package.json

{
  //...
  "dependencies": {
    "b": "1.x",
    "c": "1.x"
  }
}

// 这时你看到:虽然 b 依赖 c,但是在 a的package.json中,b和c是同级(同辈)被a引用的。

要注意依赖项的版本必须是兼容的,如果一个 peerDependency 被标为 2.x,你就不能安装 1.x 或其他不兼容的版本。该规定遵循 https://flaviocopes.com/npm-semantic-versioning/ 标准。

ref:
https://flaviocopes.com/npm-peer-dependencies/

posted @ 2023-08-09 15:41  炎黄子孙,龙的传人  阅读(157)  评论(0编辑  收藏  举报