Reusable Workflows

May 28, 2026 · View on GitHub

原文链接：

1. 解决什么问题

多仓库团队最容易出现 CI 分裂：

每个仓库一份复制粘贴的 workflow
Node、Java、Go、Python 检查方式不一致
安全扫描有的仓库有，有的仓库没有
job 名称不统一，分支保护很难配置
模板改一次，要手工改几十个仓库

Reusable workflows 用 workflow_call 把公共 CI 逻辑抽出来，让业务仓库调用统一模板。

2. 基本结构

公共仓库：

org/.github
  .github/workflows/
    java-ci.yml
    node-ci.yml
    security-scan.yml

公共 workflow：

name: java-ci

on:
  workflow_call:
    inputs:
      java-version:
        required: false
        type: string
        default: "17"

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          distribution: temurin
          java-version: ${{ inputs.java-version }}
      - run: mvn test

业务仓库调用：

name: ci

on:
  pull_request:
  push:
    branches: [main]

jobs:
  java-ci:
    uses: org/.github/.github/workflows/java-ci.yml@v1
    with:
      java-version: "21"