yarn.lock的__metadata字段中version和cacheKey代表什么？

你在yarn.lock顶部看到的这段结构：

__metadata:
  version: 5
  cacheKey: 8

是Yarn 2及以上版本（又称Yarn Berry）的lock文件专属顶层元数据字段，Yarn 1.x版本的lock文件不存在这个结构，因此旧版官方文档中没有相关说明。

两个字段的具体作用如下：

• version：标识yarn.lock文件本身的格式版本号。不同版本的Yarn对lock文件的字段定义、存储结构可能存在不兼容调整，Yarn执行安装等操作前会先读取该版本号，判断当前lock文件是否适配当前安装的Yarn版本，避免解析错误。如果版本不匹配，Yarn会自动按当前版本的规则升级lock文件结构，同时更新该字段值。
• cacheKey：标识依赖缓存的规则版本。Yarn的缓存哈希计算逻辑、依赖下载源配置、压缩算法等全局配置发生变更时，该值会同步更新。Yarn会通过该值判断当前lock文件对应的依赖缓存是否有效，避免缓存不匹配导致的依赖校验失败、安装异常问题。

注意：这两个字段均由Yarn自动生成和维护，无需手动修改，手动修改可能会触发Yarn全量重新生成lock文件的逻辑。

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