为何pnpm会将部分依赖包链接至node_modules顶层目录？

嘿，这个问题其实是对pnpm的依赖管理机制有点误解，我来给你捋清楚～

首先先打消你“前缀匹配提升”的疑惑——这些包能出现在顶层，完全是因为它们是eslint的核心直接依赖，和名称前缀半毛钱关系都没有。

我们一步步拆解：

1. 先确认eslint的依赖树 #

你可以在项目里执行这条命令验证：

pnpm list @eslint/eslintrc eslint-scope eslint-utils eslint-visitor-keys

输出会清晰显示，这些包都是eslint自身package.json里声明的直接依赖项，是eslint运行时必须的核心组件，缺了它们eslint根本跑不起来。

2. pnpm的依赖存储与链接逻辑 #

pnpm和npm/yarn的依赖管理逻辑有本质区别：

• 所有真实的依赖包都会被存在.pnpm目录里（这是pnpm节省磁盘空间的核心，同一个包的同一个版本只会在全局存一次）
• 顶层node_modules里的包，其实都是指向.pnpm对应包的符号链接（不是复制文件，只是个跳转入口）
• pnpm默认会把直接依赖的直接依赖（也就是你的项目的二级依赖）提升到顶层，目的是兼容一些依赖查找逻辑不够严谨的工具（比如早期的ESLint插件），同时又能保持依赖树的清晰性，不像npm那样无差别平铺所有依赖。

3. 为什么你会觉得“不合理”？ #

这大概率是因为你习惯了npm/yarn的完全扁平化依赖结构——它们会把所有层级的依赖尽可能平铺到顶层，不管是否存在版本冲突。而pnpm的结构更“克制”：顶层只会出现你直接安装的包，以及那些被直接依赖明确需要、且没有版本冲突的二级依赖。

如果想彻底验证这个逻辑，你可以尝试安装一个和eslint前缀无关但同样是eslint依赖的包（比如ajv，它也是eslint的依赖），你会发现它同样可能出现在顶层——这就完全证明和前缀没有任何关系啦。

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