Yarn Berry 缓存机制解析：enableGlobalCache 与 enableMirror 的区别与使用

在 Yarn Berry 包管理工具中，缓存机制是一个重要但容易被误解的功能。最近有用户反馈在设置 enableGlobalCache: false 并指定自定义全局缓存目录后，Yarn 仍然会将缓存同时存储到全局目录和用户自定义目录中。这实际上揭示了 Yarn 缓存配置中一个关键但文档说明不足的设计细节。

Yarn 缓存的双层结构

Yarn Berry 采用了双层缓存结构设计：

1. 本地缓存：位于项目目录下的 .yarn/cache 文件夹
2. 全局缓存：位于系统全局位置（如 Linux 下的 ~/.cache/yarn）

这种设计既保证了项目独立性，又实现了依赖包的跨项目共享。

配置参数解析

enableGlobalCache 参数

enableGlobalCache 参数实际上控制的是是否使用本地缓存，而非其名称暗示的全局缓存。这是一个历史命名问题，容易造成误解：

• 当设置为 true（默认值）：Yarn 会使用项目本地缓存
• 当设置为 false：Yarn 将完全禁用本地缓存机制

enableMirror 参数

真正控制全局缓存行为的参数是 enableMirror：

• 当设置为 true（默认值）：Yarn 会同时使用本地缓存和全局缓存
• 当设置为 false：Yarn 将只使用本地缓存

实际应用场景

1. 完全禁用缓存（不推荐）：

   YARN_ENABLE_GLOBAL_CACHE=false yarn install
   

2. 仅使用本地缓存：

   YARN_ENABLE_MIRROR=false yarn install
   

3. 自定义缓存位置：

   YARN_CACHE_FOLDER="/custom/cache/path" yarn install
   

最佳实践建议

1. 对于大多数开发场景，保持默认的双层缓存配置是最佳选择，因为它平衡了性能和磁盘空间的使用。

2. 在 CI/CD 环境中，可以考虑禁用镜像功能来避免不必要的全局缓存操作：

   YARN_ENABLE_MIRROR=false yarn install --immutable
   

3. 如果需要完全控制缓存位置，建议同时设置：

   YARN_CACHE_FOLDER="/custom/path" YARN_ENABLE_MIRROR=false yarn install
   

理解 Yarn Berry 缓存机制的实际工作原理，可以帮助开发者更有效地管理项目依赖和构建过程，避免因配置误解导致的意外行为。