如何通过Yarn Workspaces从多仓增量迁移至单仓？

你的理解有误，完全可以实现增量迁移，不需要一次性迁移所有关联模块，Yarn Workspaces的依赖解析机制天然支持这种渐进式迁移场景。

核心原理：Yarn的依赖优先级规则 #

当你把dependency-a迁移到workspace的packages/dependency-a目录后，只要在app的package.json里将其依赖声明为"dependency-a": "workspace:packages/dependency-a"，Yarn会强制让整个monorepo内的所有模块（包括node_modules里的dependency-b）优先使用workspace中的dependency-a版本，而不会在node_modules中重复安装dependency-a。

也就是说，哪怕dependency-b还在node_modules里，它对dependency-a的引用也会被Yarn重定向到workspace中的本地包，不需要你立刻迁移dependency-b。

具体操作步骤 #

1. 完成dependency-a的迁移：将代码移至packages/dependency-a，在该目录下初始化正确的package.json（设置好name、version等字段）。
2. 修改app的package.json，将dependency-a的依赖项改为"dependency-a": "workspace:packages/dependency-a"。
3. 运行yarn install，Yarn会自动处理依赖解析，确保dependency-b（及其他任何依赖dependency-a的模块）都使用workspace中的版本。

验证迁移效果 #

可以通过Yarn的内置命令确认依赖路径：

yarn why dependency-a

输出结果里会显示dependency-b是从workspace的dependency-a获取依赖，而非node_modules中的版本。

注意事项 #

• 版本兼容性：确保dependency-a的版本号符合dependency-b的package.json中声明的依赖范围。如果版本不兼容，Yarn可能会额外安装一份node_modules版本的dependency-a。这种情况下，你可以：
  • 临时调整dependency-b的依赖范围（比如放宽到兼容当前dependency-a的版本）
  • 在workspace中调整dependency-a的版本，使其符合dependency-b的要求
    这两步都可以渐进式完成，不需要一次性修改所有关联模块。
• Yarn版本差异：Yarn 1.x需要确保package.json中正确配置了workspaces字段并启用了hoisting；Yarn 2+（Berry）默认就会自动处理这种依赖优先级，无需额外配置。

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