Yarn Berry 项目中的依赖管理：解决 Monorepo 脚本执行问题

在大型前端项目中，Monorepo 架构因其代码共享和统一管理的优势而广受欢迎。Yarn Berry 作为新一代包管理工具，为 Monorepo 提供了更强大的支持。然而，在从 Yarn Classic 迁移到 Yarn Berry 的过程中，开发者经常会遇到一个典型问题：在子包中执行依赖命令时出现"command not found"错误。

问题背景

在一个典型的 Yarn Berry Monorepo 结构中，项目可能包含多个应用和共享库。根目录的 package.json 通常包含构建工具等开发依赖（如 webpack、typescript 等），而各个子包则包含具体的业务代码和构建脚本。当尝试在子包中执行这些构建命令时，系统会报错提示找不到命令。

问题本质

这个问题的根源在于 Yarn Berry 的工作区隔离机制。与 Yarn Classic 不同，Yarn Berry 不会自动将根目录安装的二进制文件暴露给所有工作区。这种设计是有意为之的，它提高了依赖关系的明确性和隔离性，但也带来了迁移时的兼容性问题。

解决方案分析

1. 使用 run -T 参数

最直接的解决方案是在命令前添加 run -T 参数。这个参数告诉 Yarn 从工作区的根目录查找命令，而不是当前工作区。例如：

yarn run -T webpack --mode production

这种方法虽然有效，但在大型 Monorepo 中（如包含 200+ 包的项目），逐个修改所有脚本会非常繁琐且容易出错。

2. 配置 .yarnrc.yml

更优雅的解决方案是通过 Yarn 的配置文件进行全局设置。在项目根目录的 .yarnrc.yml 文件中添加以下配置：

enableInlineBuilds: true

这个配置会启用内联构建，允许工作区访问根目录安装的工具链。它相当于为所有工作区隐式添加了 -T 参数，而不需要修改每个脚本。

3. 显式声明依赖

从工程最佳实践角度考虑，更推荐的做法是在每个使用构建工具的包中显式声明这些开发依赖。虽然这会增加一些重复声明，但它使每个包的依赖关系更加明确，提高了项目的可维护性和可移植性。

进阶建议

1. 渐进式迁移：对于大型项目，建议采用渐进式迁移策略，可以先在部分包中测试 Yarn Berry 的兼容性。

2. 统一工具版本：利用 Yarn Berry 的依赖约束功能，确保所有包使用相同版本的构建工具，避免版本冲突。

3. 自定义命令：考虑在根目录 package.json 中定义统一的构建命令，通过参数指定目标包，减少重复配置。

4. 文档更新：在迁移过程中，及时更新项目文档，记录新的构建流程和注意事项。

总结

Yarn Berry 在 Monorepo 管理上提供了更强大和精确的控制能力，但这也意味着开发者需要更明确地声明依赖关系。通过合理配置 .yarnrc.yml 或调整项目结构，可以平衡便利性和明确性。对于从 Yarn Classic 迁移的项目，理解这些差异并采取适当的解决方案，将有助于充分发挥 Yarn Berry 的优势，构建更健壮的前端工程体系。