如何在Github Actions中使用Yarn 3.5？解决模块找不到错误

问题原因 #

GitHub Actions的Ubuntu运行器预装了通过npm install -g yarn安装的Yarn 1.x，它会优先于Corepack管理的Yarn被调用。而Yarn 1.x不识别.yarnrc.yml中的yarnPath配置，导致找不到项目指定的Yarn 3.5.0文件，从而抛出MODULE_NOT_FOUND错误。

解决步骤 #

1. 确保核心文件已提交到Git #

检查仓库是否包含以下文件，若缺失则添加并提交：

• .yarn/releases/yarn-3.5.0.cjs：Yarn 3.5.0的可执行文件
• .yarnrc.yml：项目的Yarn配置文件
• package.json：已添加packageManager: "yarn@3.5.0"字段（用于Corepack识别版本）

2. 更新GitHub Actions配置（lint.yml） #

修改后的配置会先移除全局旧版Yarn，再启用Corepack，确保使用项目指定的Yarn版本：

name: Lint

on:
  push:
    branches:
      - main
  pull_request:
    branches:
      - main

jobs:
  run-linters:
    name: Run linters
    runs-on: ubuntu-latest

    steps:
      - name: Check out Git repository
        uses: actions/checkout@v3

      - name: Use Node.js
        uses: actions/setup-node@v3
        with:
          node-version: "16.17"
          cache: 'yarn'

      - name: 移除全局预装的Yarn 1.x
        run: sudo npm uninstall -g yarn

      - name: 启用Corepack
        run: corepack enable

      - name: 安装Node.js依赖
        run: yarn install --immutable --immutable-cache --check-cache

      - name: Run eslint
        run: yarn eslint src/ --max-warnings=0

      - name: Run Prettier
        run: yarn prettier src/ --check

3. 逻辑说明 #

• 移除全局Yarn 1.x：消除旧版本对Corepack的干扰，确保后续yarn命令调用的是Corepack管理的版本
• 启用Corepack：让Node.js通过Corepack管理Yarn，Corepack会自动读取package.json的packageManager字段或.yarnrc.yml的yarnPath，加载项目指定的Yarn 3.5.0
• 提交Yarn可执行文件：确保运行器拉取代码后能找到.yarn/releases/yarn-3.5.0.cjs，避免文件缺失错误

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