为什么pnpm中每个项目的virtual-store-dir必须唯一？

这问题问得挺到位的，我刚接触pnpm的时候也有过同样的疑惑——毕竟看起来每个包都带版本号，好像共享也不会冲突？其实这里的核心原因和pnpm的硬链接/符号链接机制以及项目依赖的隔离性有关，我给你举几个实际例子你就懂了：

1. 相对路径导致的符号链接失效问题 #

pnpm的虚拟仓库里，每个包内部引用依赖时用的是相对路径。假设我们有两个结构不同的项目：

• 项目A在/user/projects/web-app目录下，依赖p-locate@5.0.0，这个包会通过相对路径指向虚拟仓库里的p-limit@3.1.0
• 项目B在/user/projects/mobile-app目录下，依赖p-locate@4.1.0，对应依赖的是p-limit@2.3.0

如果两个项目共享同一个virtual-store-dir，那么从项目A的node_modules到虚拟仓库的相对路径，和项目B的完全不一样。这会导致其中一个项目的符号链接无法正确找到依赖包，直接抛出模块找不到的错误。

2. 依赖上下文的冲突问题 #

有些包（比如带native模块的工具包）在安装时会基于当前项目的环境生成特定的编译产物，这些产物会放在虚拟仓库对应的包目录下。如果两个项目共享虚拟仓库：

• 项目A可能是基于Node.js 16环境编译的产物
• 项目B是基于Node.js 20环境编译的产物
  这时候两个项目的编译产物会互相覆盖，导致其中一个项目运行时出现兼容性错误。

为什么workspace可以共享？ #

至于pnpm允许workspace根目录共享虚拟仓库，是因为workspace下所有子项目的相对路径都是统一指向根目录的，符号链接的路径不会出现差异，而且所有子项目共享同一个环境上下文，不会出现上述的冲突问题。

你看到的版本化文件夹确实是pnpm避免版本重复的基础，但这只是解决了包本身的版本重复问题，而跨项目的路径差异和依赖上下文的隔离才是不能共享虚拟仓库的核心原因。

备注：内容来源于stack exchange，提问作者TSR