使用Yarn4 PNP的NX Monorepo中如何集中管控依赖版本？

给你几个适配Yarn 4 PNP规则的实操方案，既能满足项目级依赖声明要求，又能强制所有项目共用统一版本：

1. 用Yarn的packageExtensions锁死版本约束 #

在根目录的.yarnrc.yml里配置packageExtensions，直接给指定依赖强制设定版本范围，不管哪个项目的package.json怎么声明，Yarn都会统一用你指定的版本：

packageExtensions:
  # 强制所有项目的react版本为18.2.x
  "react@*":
    version: "^18.2.0"
  # 同步@types/react的版本并对齐peer依赖
  "@types/react@*":
    version: "^18.2.0"
    peerDependencies:
      react: "^18.2.0"

这种方式完全符合Yarn PNP的规则，从包管理层面直接锁死版本一致性。

2. 用NX的版本检查命令+流程管控 #

NX自带的enforce-matching-versions命令可以扫描所有项目的依赖版本，配合git钩子或CI流程，强制版本不一致时无法提交或构建：

• 先在根package.json的scripts里添加检查命令：

"scripts": {
  "check-unified-deps": "nx enforce-matching-versions --deps react,@types/react,lodash"
}

• 用husky之类的工具配置pre-commit钩子，每次提交前自动运行yarn check-unified-deps，只要有项目版本不符合规范就阻止提交。
  这种方式从协作流程上确保所有代码的依赖版本统一。

3. 用Yarn workspace协议共享根版本 #

在根package.json里声明统一版本的依赖，然后各个项目的package.json用workspace:*引用，Yarn PNP会自动识别并使用根目录的版本：

• 根package.json（仅在根定义统一版本）：

"devDependencies": {
  "@types/node": "^20.10.0"
}

• 每个项目的package.json（通过workspace协议引用根版本）：

"devDependencies": {
  "@types/node": "workspace:*"
}

这样既满足Yarn PNP要求的项目级依赖声明，又能让所有项目共用根目录定义的版本，NX也能完美识别这种共享方式。

4. 写NX Generator批量同步版本 #

因为你有122个项目，手动修改每个项目的package.json效率太低，可以写一个NX Generator脚本批量处理：

• 用NX的Generator API遍历所有项目，读取项目的package.json文件，将目标依赖的版本替换为统一值；
• 更新完成后自动运行yarn install让Yarn PNP同步依赖；
• 可以把这个脚本加到CI流程定期执行，或者手动触发批量更新。

内容的提问来源于stack exchange，提问作者Joey Yi Zhao