Yarn 3.6.1 Monorepo部署Vercel时.vercelignore引发YN0028错误如何解决？

方案1：使用Yarn工作区过滤安装（推荐） #

Yarn 3+提供的workspaces focus命令可精准安装指定工作区的依赖（包括其依赖的本地packages），不会因缺少无关工作区修改lock文件。

• 直接在Vercel的Install Command中替换为：

  yarn workspaces focus @your-project/your-web-app --production
  

  将@your-project/your-web-app替换为你要部署的Web应用在monorepo中的工作区名称。

• 也可在项目根目录package.json中添加专用脚本：

  {
    "scripts": {
      "vercel:install": "yarn workspaces focus @your-project/your-web-app --production"
    }
  }
  

  随后在Vercel控制台的安装命令中填写yarn vercel:install。

此方法会严格安装目标应用所需的所有依赖，同时保持lock文件与本地一致，彻底规避YN0028错误。

方案2：精细化配置.vercelignore #

不要盲目忽略所有其他工作区，仅忽略完全不被目标Web应用依赖的apps或packages：

假设你的monorepo结构如下：

├── apps/
│   ├── web-app/       # 待部署应用
│   └── admin-app/     # 无关应用，可忽略
└── packages/
    ├── common/        # web-app依赖的包，不能忽略
    └── utils/         # web-app依赖的包，不能忽略

那么.vercelignore应编写为：

apps/admin-app/

保留所有被web-app依赖的packages和必要文件，Vercel执行yarn install时就能找到完整的工作区依赖链，lock文件不会被修改。

方案3：临时禁用锁文件不可变校验（不推荐） #

如果以上方法无法快速落地，可临时关闭Yarn的lock文件校验，但这会带来依赖版本不一致的风险，仅作为应急方案：

• 在Vercel控制台的环境变量中添加：
  YARN_ENABLE_IMMUTABLE_INSTALLS=false

• 或在项目根目录.yarnrc.yml中添加：

  enableImmutableInstalls: false
  

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