pnpm monorepo根目录install后工作区无依赖原因咨询

核心原因 #

pnpm的Workspace模式默认采用集中式存储+软链映射的机制：

• 根目录的node_modules是全局依赖存储区，所有工作区共享这里的依赖包
• 工作区本地的node_modules只会出现以下几种情况：
  • 工作区自身独有的、版本与根目录不一致的依赖
  • 指向根目录依赖的软链接（部分系统显示为快捷方式）
  • 工作区之间的相互依赖（比如通过workspace协议引用的包）

你看到工作区node_modules为空，本质是所有依赖都能通过根目录的存储满足，pnpm没必要在工作区重复生成实体文件或软链。

你尝试的命令问题说明 #

1. pnpm add --filer：这是拼写错误，正确命令是pnpm add --filter <工作区名称>，作用是给指定工作区安装依赖，而非全局
2. pnpm -W add：-W（或--workspace-root）是给根目录安装依赖，这些依赖会被所有工作区共享，自然不会出现在单个工作区的node_modules里

正确操作方式 #

如果要给某个工作区单独安装依赖：

• 执行pnpm add <包名> --filter <工作区名称>，比如你的工作区叫app1，就运行pnpm add lodash --filter app1，此时依赖会被安装到根目录存储区，同时在app1的node_modules生成软链
• 若要让工作区使用独有的依赖版本，直接修改该工作区的package.json，再执行根目录的pnpm install，pnpm会自动处理版本差异，在工作区node_modules生成对应软链或实体文件

如果要验证依赖是否生效：

• 直接在工作区代码里引入依赖运行，pnpm的模块解析机制会自动找到根目录的存储
• 执行pnpm ls --filter <工作区名称>，可以查看该工作区已安装的依赖列表，包括共享的根目录依赖

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