GitHub Actions矩阵步骤完成后如何实现单次Git提交推送？

问题本质 #

GitHub Actions的矩阵（matrix）任务是完全独立的运行环境，每个矩阵实例会单独执行仓库检出、文件创建操作，它们的文件系统相互隔离。你之前把提交步骤放在矩阵之后，只能获取到第一个矩阵实例生成的文件；若某个实例提前提交了变更，后续步骤还会因为远程仓库有新提交而触发pull冲突。

方案1：放弃矩阵，单步骤循环生成文件 #

如果文件生成逻辑可以用循环实现，直接在单个步骤遍历所有参数创建文件，所有文件会在同一运行环境中，直接提交即可。示例配置：

jobs:
  generate-and-commit:
    runs-on: ubuntu-latest
    steps:
      - name: 检出仓库
        uses: actions/checkout@v4

      - name: 批量生成文件
        run: |
          # 替换为你原矩阵中的参数列表
          for param in "param1" "param2" "param3"; do
            # 替换为你的文件生成逻辑
            echo "内容：$param" > "file-$param.txt"
          done

      - name: 提交并推送
        uses: EndBug/add-and-commit@v9
        with:
          message: "新增所有生成的文件"
          push: true

方案2：用Artifacts收集矩阵文件，依赖Job合并提交 #

若必须用矩阵并行生成文件，需让每个矩阵实例上传生成的文件为Artifacts，再在依赖Job中下载所有Artifacts并合并提交：

步骤1：矩阵Job生成并上传文件

jobs:
  generate-files:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        param: ["param1", "param2", "param3"]
    steps:
      - name: 检出仓库
        uses: actions/checkout@v4

      - name: 生成${{ matrix.param }}对应的文件
        run: |
          echo "内容：${{ matrix.param }}" > "file-${{ matrix.param }}.txt"

      - name: 上传生成的文件为Artifacts
        uses: actions/upload-artifact@v4
        with:
          name: generated-files-${{ matrix.param }}
          path: file-${{ matrix.param }}.txt

步骤2：依赖Job下载并合并提交

commit-files:
    runs-on: ubuntu-latest
    needs: generate-files
    steps:
      - name: 检出仓库
        uses: actions/checkout@v4

      - name: 下载所有生成的Artifacts
        uses: actions/download-artifact@v4
        with:
          path: ./generated-artifacts

      - name: 复制所有文件到仓库根目录
        run: |
          cp -r ./generated-artifacts/**/*.txt ./

      - name: 提交并推送
        uses: EndBug/add-and-commit@v9
        with:
          message: "提交矩阵生成的所有文件"
          push: true

注意事项 #

• Artifacts命名需带唯一标识（如矩阵参数），避免不同实例的文件互相覆盖
• 若提交时仍出现pull冲突，可在提交步骤前添加命令：git pull origin main --rebase（替换main为你的目标分支名）

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