pnpm monorepo 中为特定包配置依赖版本覆盖的实现方案（原 yarn resolutions 场景迁移）

嘿，我之前从yarn迁移到pnpm monorepo时，也碰到过这种需要给不同子包指定不同依赖版本的情况，刚好你的场景和我当时几乎一模一样——RN子包用旧版react，Next.js子包用新版，还有一堆其他包要单独配置。下面是我亲测有效的几种方案，你可以根据自己的需求选：

方案一：子包本地配置专属版本覆盖（最直观，适合零散配置） #

pnpm支持在单个子包的package.json里配置pnpm.overrides，这个配置只会对当前子包的依赖树生效，完美替代yarn子包级别的resolutions。

比如针对你的apps/mobile包，直接在它的package.json里添加：

{
  "name": "mobile",
  // 其他原有配置...
  "pnpm": {
    "overrides": {
      "react": "18.x.y",
      // 其他需要单独覆盖的包都写在这里，比如：
      "react-dom": "18.x.y",
      "some-other-dep": "2.3.4"
    }
  }
}

而apps/admin和apps/client的package.json里，要么直接把react声明为19.x.y（因为直接声明的版本优先级最高），要么也可以加对应的pnpm.overrides来强制锁定。

这种方式的好处是每个子包的版本规则都放在自己的配置里，清晰明了，适合需要单独微调的场景。

方案二：根目录统一配置多工作区版本规则（适合批量管理） #

如果你的需要覆盖的包很多，想在根目录统一管理所有子包的版本规则，可以用pnpm的工作区条件语法在根package.json里配置全局overrides，针对不同子包指定不同版本。

比如根package.json的配置如下：

{
  "name": "monorepo-root",
  // 其他原有配置...
  "pnpm": {
    "overrides": {
      // 针对react的多工作区版本规则
      "react": {
        "apps/mobile": "18.x.y",
        // 所有其他工作区（包括admin、client、packages/ui）用19.x.y
        "*": "19.x.y"
      },
      // 其他需要批量覆盖的包同理
      "some-shared-dep": {
        "apps/mobile": "1.0.0",
        "apps/*": "2.0.0",
        "packages/*": "2.0.0"
      }
    }
  }
}

这里的apps/mobile是工作区的相对路径，*是通配符，支持匹配多个工作区，非常适合批量管理规则。

额外注意事项 #

• 配置完成后，记得运行pnpm install（或者pnpm i）让pnpm重新解析依赖树，确保覆盖生效。
• 对于共享的packages/ui，因为它只在admin和client中使用，建议在它的package.json里声明peerDependencies：

  {
    "peerDependencies": {
      "react": "^19.x.y"
    }
  }
  

  这样可以确保admin和client安装时，ui包会复用宿主的react版本，避免不必要的版本冲突。
• 如果遇到覆盖不生效的情况，可以用pnpm why react（替换成对应的包名）来排查依赖树，看看哪个依赖没有被正确覆盖。

内容来源于stack exchange