Turborepo monorepo中如何合并yarn.lock重复包版本？

问题背景 #

用Vercel Turborepo管理monorepo时，已将所有package.json中的依赖版本统一为兼容范围，但yarn.lock文件中仍存在大量重复的不同版本包记录。例如tailwindcss的锁文件内容：

tailwindcss@^3.2.4:
  version "3.3.3"
  resolved "https://registry.yarnpkg.com/tailwindcss/-/tailwindcss-3.3.3.tgz#90da807393a2859189e48e9e7000e6880a736daf"
  integrity sha512-A0KgSkef7eE4Mf+nKJ83i75TMyq8HqY3qmFIJSWy8bNt0v1lG7jUcpGpoTFxAwYcWOphcTBLPPJg+bDfhDf52w==
  dependencies:
    ...

tailwindcss@^3.3.0:
  version "3.4.1"
  resolved "https://registry.yarnpkg.com/tailwindcss/-/tailwindcss-3.4.1.tgz#f512ca5d1dd4c9503c7d3d28a968f1ad8f5c839d"
  integrity sha512-qAYmXRfk3ENzuPBakNK0SRrUDipP8NQnEY6772uDhflcQz5EhRdD7JNZxyrFHVQNCwULPBn6FNPp9brpO7ctcA==
  dependencies:
    ...

tailwindcss@^3.3.1:
  version "3.3.2"
  resolved "https://registry.yarnpkg.com/tailwindcss/-/tailwindcss-3.3.2.tgz#2f9e35d715fdf0bbf674d90147a0684d7054a2d3"
  integrity sha512-9jPkMiIBXvPc2KywkraqsUfbfj+dHDb+JPWtSJa9MLFdrPyazI7q6WX2sUrm7R9eVR7qqv3Pas7EvQFzxKnI6w==
  dependencies:
    ...

按Semver规则，带^的非零版本应兼容同一大版本的最新包，但实际未合并，导致类型不兼容问题：

Type 'import("...").ReactNode' is not assignable to type 'import("...").ReactNode'.

补充示例：@types/node的锁文件也存在类似问题：

"@types/node@20.x":
  version "20.11.24"
  resolved "https://registry.yarnpkg.com/@types/node/-/node-20.11.24.tgz#cc207511104694e84e9fb17f9a0c4c42d4517792"
  integrity sha512-Kza43ewS3xoLgCEpQrsT+xRo/EJej1y0kVYGiLFE1NEODXGzTfwiC6tXTLMQskn1X4/Rjlh0MQUvx9W+L9long==
  dependencies:
    undici-types "~5.26.4"

"@types/node@^20":
  version "20.11.20"
  resolved "https://registry.yarnpkg.com/@types/node/-/node-20.11.20.tgz#f0a2aee575215149a62784210ad88b3a34843659"
  integrity sha512-7/rR21OS+fq8IyHTgtLkDK949uzsa6n8BkziAKtPVpugIkO6D+/ooXMvzXxDnZrmtXVfjb1bKQafYpb8s89LOg==
  dependencies:
    undici-types "~5.26.4"

期望实现类似@types/react的合并效果：

"@types/react@*", "@types/react@18.x", "@types/react@>=16", "@types/react@^18":
  version "18.2.57"
  resolved "https://registry.yarnpkg.com/@types/react/-/react-18.2.57.tgz#147b516d8bdb2900219acbfc6f939bdeecca7691"
  integrity sha512-ZvQsktJgSYrQiMirAN60y4O/LRevIV8hUzSOSNB6gfR3/o3wCBFQx3sPwIYtuDMeiVgsSS3UzCV26tEzgnfvQw==
  dependencies:
    ...

核心问题 #

1. 如何合并所有匹配的依赖记录，让它们共用同一个物理安装包？
2. 如何设置为安装/更新时的默认行为，自动合并符合Semver规则的依赖版本？

解决方案 #

一、手动合并现有依赖记录 #

1. 统一版本范围：确保所有子包和根package.json中的目标依赖使用相同的版本范围（例如将tailwindcss的所有引用统一为^3.4.1，或20.x这类统一范围）。
2. 执行依赖去重：在根目录运行以下命令：

   yarn dedupe
   

   该命令会分析所有依赖的版本兼容性，自动合并可共用的包记录，更新yarn.lock。
3. 强制重新生成锁文件：如果dedupe未完全生效，可清理缓存后重新安装：

   yarn cache clean
   rm -rf node_modules yarn.lock
   yarn install
   

   重新安装会基于当前package.json的版本范围，生成全新的锁文件，自动合并符合条件的依赖。

二、设置默认合并行为 #

1. 配置Yarn自动去重：在根目录的.yarnrc文件中添加如下配置，强制Yarn在每次安装时自动执行去重：

   dedupe-force true
   

2. 统一版本范围策略：所有子包使用相同的版本范围规则（例如统一用^x.y.z而非混合^x.y.z和x.x），减少Yarn需要处理的版本差异。
3. Turborepo统一更新脚本：在根package.json的scripts中添加统一更新脚本，方便批量更新并自动去重：

   "scripts": {
     "update:deps": "yarn up <package-name>@latest && yarn dedupe"
   }
   

   替换<package-name>为目标依赖，或使用yarn up *@latest更新所有依赖。

问题原因说明 #

• Yarn锁文件会保留历史安装的版本记录，即使更新了package.json的版本范围，旧条目不会自动删除，需主动触发去重操作。
• 不同的版本范围（如20.x和^20）虽Semver兼容，但Yarn默认优先保留已安装版本，避免意外更新，需手动或配置自动去重。
• 子包的间接依赖可能引入旧版本包，导致锁文件残留，需通过dedupe清理冗余记录。

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