Yarn Workspaces 中如何同时聚焦根工作区和子工作区

在Yarn Workspaces的使用过程中，开发者经常会遇到需要同时处理根工作区和特定子工作区依赖的场景。本文将深入探讨这一需求的技术背景和解决方案。

问题背景

当使用Yarn Workspaces管理多包项目时，项目结构通常包含一个根工作区（root workspace）和多个子工作区。根工作区通常存放共享配置（如lint规则、构建工具配置等），而子工作区则包含具体的业务逻辑和测试代码。

在持续集成(CI)环境中，开发者往往需要：

1. 安装根工作区的依赖以运行lint等共享工具
2. 同时安装特定子工作区的依赖以运行测试

技术挑战

Yarn的workspaces focus命令默认不支持直接指定根工作区（用"."表示）。当尝试运行类似yarn workspaces focus . foo bar的命令时，系统会抛出"Workspace not found (.)"的错误。

解决方案

实际上，Yarn已经提供了解决这一问题的方案：

1. 为根工作区命名：在package.json中明确指定根工作区的名称
2. 使用命名引用：在focus命令中使用这个名称而非"."来引用根工作区

实现细节

1. 在根目录的package.json中，确保workspaces字段包含明确的名称定义：

{
  "name": "my-root-workspace",
  "workspaces": ["packages/*"]
}

2. 然后可以使用以下命令同时聚焦根工作区和子工作区：

yarn workspaces focus my-root-workspace foo bar

技术原理

Yarn内部使用"."表示根工作区的位置，但在命令接口层面，它期望使用package.json中定义的正式名称。通过yarn workspaces list --json命令可以清楚地看到每个工作区的名称和位置信息。

最佳实践

1. 始终为根工作区定义明确的名称
2. 在CI脚本中使用--json标志获取准确的工作区信息
3. 避免分多次运行focus命令，以减少认证和安装时间

这种设计既保持了命令接口的简洁性，又提供了足够的灵活性来满足复杂项目的需求。