Yarn install在不同分支行为差异：YN0070/node_modules vs PnP原因解析

核心原因：yarn.lock格式版本不同 #

Yarn 3（Berry）会根据yarn.lock的格式自动切换依赖管理模式：

• 当分支的yarn.lock是Yarn 1版本格式时，Yarn 3会触发自动迁移（即你看到的YN0070提示），启用node-modules兼容链接器，生成.yarnrc.yml并创建node_modules目录，以此适配旧版Yarn的依赖结构。
• 当分支的yarn.lock是Yarn 3+版本格式时，Yarn 3会默认使用PnP（Plug'n'Play）模式，生成.pnp.cjs和.pnp.loader.mjs文件，不创建node_modules——这是Yarn 3原生的高效依赖管理方式。

快速区分两种yarn.lock格式 #

• Yarn 1格式的锁文件开头会有明确标识：

  # THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
  # yarn lockfile v1
  

• Yarn 3+格式的锁文件开头会包含元数据块：

  # This file is generated by running "yarn install" inside your project.
  # Manual changes might be lost - proceed with caution!
  
  __metadata:
    version: 6
    cacheKey: 8
  

统一行为的两种方案 #

方案1：全分支使用PnP模式 #

在带有Yarn 1格式yarn.lock的分支执行：

yarn install --immutable

Yarn会自动将锁文件升级为Yarn 3格式，后续安装就会统一使用PnP模式。

方案2：全分支使用node-modules模式 #

在项目根目录创建或修改.yarnrc.yml，添加以下配置：

nodeLinker: node-modules

将这个文件提交到所有分支，之后无论锁文件格式如何，Yarn都会使用node_modules目录管理依赖。

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