pnpm v7为何为同一库创建多个实例？

项目信息 #

目录结构 #

└── my-project/
    ├── apps/
    │   └── myapp/
    │       ├── package1
    │       ├── package2
    │       └── styled-components@5.3.9
    ├── packages/
    │   ├── package1/
    │   │   └── styled-components@5.3.9
    │   └── package2/
    │       ├── package1
    │       └── styled-components@5.3.9
    ├── package.json
    └── pnpm-workspace.yaml

依赖关系 #

• myapp 依赖 package1、package2 和 styled-components
• package1 依赖 styled-components
• package2 依赖 package1 和 styled-components

所有依赖均声明在对应包的 package.json 的 dependencies 字段中

环境与配置 #

• Node.js 版本：18.15.0
• pnpm 版本：7.29.2
• .npmrc 配置：

public-hoist-pattern[]=@types*
dedupe-peer-dependents=true
resolve-peers-from-workspace-root=true 

问题 #

查看项目根目录下的 /node_modules/.pnpm 时，发现生成了两个 styled-components 相关文件夹，预期同版本依赖应该只有一个实例，想明确 pnpm 此行为的原因。

原因分析 #

pnpm 在 .pnpm 目录下生成多个同版本包目录的核心逻辑是依赖上下文唯一性：即使包的版本号完全一致，只要它们所处的依赖树上下文存在差异（比如需要满足的 peer 依赖集合、依赖来源的层级、所属工作区包的隔离环境），pnpm 就会为其创建带有哈希后缀的独立目录入口。不过注意：这些目录的物理文件是通过硬链接复用的，不会重复占用磁盘空间。

针对你的场景，具体触发因素包括：

1. 工作区包的依赖隔离机制：pnpm 默认保证工作区内每个包的依赖环境独立。myapp、package1、package2 作为工作区的不同实体，它们对 styled-components 的依赖属于不同的解析上下文——比如 package1 的 styled-components 是自身直接依赖，package2 的 styled-components 既是自身直接依赖，又需要配合其依赖的 package1 的依赖环境，这种层级差异会让 pnpm 认为需要创建独立的目录入口。
2. 配置项的局限性：你设置的 dedupe-peer-dependents=true 仅对 peer 依赖的重复包生效，而 styled-components 是直接依赖，因此该配置无法触发它的合并。resolve-peers-from-workspace-root=true 强制从根目录解析 peer 依赖，但如果根目录 package.json 未声明 styled-components 相关的 peer 依赖，反而会加剧各工作区包的解析上下文差异，阻碍自动 deduplication。
3. 依赖传递的层级差异：myapp 直接依赖 styled-components，同时依赖 package1 和 package2；而 package1、package2 也各自直接依赖 styled-components。pnpm 为了保持依赖树的清晰性，不会自动合并这些分属不同层级的同版本直接依赖，除非显式配置强制合并。

优化建议 #

如果希望强制合并同版本的 styled-components 实例，可以尝试以下操作：

• 在工作区根目录的 package.json 中添加 styled-components@5.3.9 到 dependencies 或 devDependencies，利用 resolve-peers-from-workspace-root 配置让所有工作区包复用根目录的依赖实例。
• 在 .npmrc 中添加 auto-install-peers=true，确保 peer 依赖被自动安装并统一解析，减少上下文差异。
• 执行 pnpm dedupe 命令手动触发依赖合并，检查是否能将同版本的 styled-components 合并为一个实例。

内容的提问来源于stack exchange，提问作者Alice