版本: 9.x

同级依赖解析

pnpm 最好的功能之一是在一个项目中，特定版本的包始终只有一组依赖项。不过，有一个例外 - 具有同级依赖的包。

同级依赖从依赖项图中更高层安装的依赖项中解析，因为它们与父级共享相同的版本。这意味着如果 foo@1.0.0 有两个同级依赖（bar@^1 和 baz@^1），那么它可能在同一个项目中具有多个不同的依赖项集。

- foo-parent-1
  - bar@1.0.0
  - baz@1.0.0
  - foo@1.0.0
- foo-parent-2
  - bar@1.0.0
  - baz@1.1.0
  - foo@1.0.0

在上面的示例中，foo@1.0.0 为 foo-parent-1 和 foo-parent-2 安装。这两个包都有 bar 和 baz，但它们依赖于不同版本的 baz。因此，foo@1.0.0 有两组不同的依赖项：一组是 baz@1.0.0，另一组是 baz@1.1.0。为了支持这些用例，pnpm 必须像不同依赖项集的数量一样多次硬链接 foo@1.0.0。

通常，如果一个包没有同级依赖，它会被硬链接到一个 node_modules 文件夹中，该文件夹位于其依赖项的符号链接旁边，如下所示

node_modules
└── .pnpm
    ├── foo@1.0.0
    │   └── node_modules
    │       ├── foo
    │       ├── qux   -> ../../qux@1.0.0/node_modules/qux
    │       └── plugh -> ../../plugh@1.0.0/node_modules/plugh
    ├── qux@1.0.0
    ├── plugh@1.0.0

但是，如果 foo 有同级依赖，那么它可能有多组依赖项，因此我们为不同的同级依赖解析创建不同的集合

node_modules
└── .pnpm
    ├── foo@1.0.0_bar@1.0.0+baz@1.0.0
    │   └── node_modules
    │       ├── foo
    │       ├── bar   -> ../../bar@1.0.0/node_modules/bar
    │       ├── baz   -> ../../baz@1.0.0/node_modules/baz
    │       ├── qux   -> ../../qux@1.0.0/node_modules/qux
    │       └── plugh -> ../../plugh@1.0.0/node_modules/plugh
    ├── foo@1.0.0_bar@1.0.0+baz@1.1.0
    │   └── node_modules
    │       ├── foo
    │       ├── bar   -> ../../bar@1.0.0/node_modules/bar
    │       ├── baz   -> ../../baz@1.1.0/node_modules/baz
    │       ├── qux   -> ../../qux@1.0.0/node_modules/qux
    │       └── plugh -> ../../plugh@1.0.0/node_modules/plugh
    ├── bar@1.0.0
    ├── baz@1.0.0
    ├── baz@1.1.0
    ├── qux@1.0.0
    ├── plugh@1.0.0

我们创建符号链接到 foo@1.0.0_bar@1.0.0+baz@1.0.0 中的 foo 或 foo@1.0.0_bar@1.0.0+baz@1.1.0 中的 foo。因此，Node.js 模块解析器将找到正确的同级依赖。

如果一个包没有同级依赖，但其依赖项具有在图中更高层解析的同级依赖，那么该传递包可能会以不同的依赖项集出现在项目中。例如，有一个包 a@1.0.0，它只有一个依赖项 b@1.0.0。b@1.0.0 有一个同级依赖 c@^1。a@1.0.0 永远不会解析 b@1.0.0 的同级依赖，因此它也成为 b@1.0.0 的同级依赖的依赖项。

以下是该结构在 node_modules 中的外观。在这个示例中，a@1.0.0 需要在项目的 node_modules 中出现两次 - 一次解析为 c@1.0.0，另一次解析为 c@1.1.0。

node_modules
└── .pnpm
    ├── a@1.0.0_c@1.0.0
    │   └── node_modules
    │       ├── a
    │       └── b -> ../../b@1.0.0_c@1.0.0/node_modules/b
    ├── a@1.0.0_c@1.1.0
    │   └── node_modules
    │       ├── a
    │       └── b -> ../../b@1.0.0_c@1.1.0/node_modules/b
    ├── b@1.0.0_c@1.0.0
    │   └── node_modules
    │       ├── b
    │       └── c -> ../../c@1.0.0/node_modules/c
    ├── b@1.0.0_c@1.1.0
    │   └── node_modules
    │       ├── b
    │       └── c -> ../../c@1.1.0/node_modules/c
    ├── c@1.0.0
    ├── c@1.1.0