GitHub Actions条件步骤优化与子工作流调用失败问题

核心根源 #

你混淆了可重用工作流和自定义Action的规则，这是所有报错的核心：

• 可重用工作流是普通.yml工作流文件，靠workflow_call触发，根本不需要改名为action.yml
• 只有自定义Action才要求action.yml作为入口文件，两者的定义、调用逻辑完全不同

逐个问题修复 #

1. 直接调用主工作流提示找不到action.yml #

这是因为你把可重用工作流当成自定义Action来调用了。正确的可重用工作流调用方式是：

# 包装器工作流示例
jobs:
  call-main-workflow:
    uses: <你的仓库路径>/.github/workflows/主工作流原文件名.yml@main
    with:
      # 按需传递主工作流需要的参数

别改主工作流文件名，保持原样就行。

2. 重命名为action.yml后提示“无事件触发器定义” #

自定义Action的action.yml不需要on字段，但可重用工作流必须加on: workflow_call。你改文件名后，GitHub把它识别成了Action，可你又按工作流的逻辑加了on字段，直接冲突了。改回原工作流文件名，加上on: workflow_call就好。

3. 添加on: workflow_call后出现Unrecognized named-value: 'steps'错误 #

这是因为你在workflow_call的输出定义里直接引用了steps上下文，可重用工作流不允许这么做。必须先把步骤的输出提升为job级别输出，再在workflow_call里引用job的输出：

# 主工作流（可重用）正确写法
on:
  workflow_call:
    outputs:
      my-output:
        description: "示例输出"
        value: ${{ jobs.main-job.outputs.job-output }}

jobs:
  main-job:
    runs-on: ubuntu-latest
    outputs:
      job-output: ${{ steps.step1.outputs.result }}
    steps:
      - id: step1
        run: echo "result=hello" >> $GITHUB_OUTPUT

记住：workflow_call的输出只能引用job的输出，不能直接跨层级拿steps的输出。

4. 修改输出格式仍未解决 #

检查两个关键细节：

• 主工作流里的步骤输出必须用$GITHUB_OUTPUT（GitHub Actions v2+标准写法，别用旧的set-output命令）
• 包装器工作流要接收输出的话，得先在调用的job里定义输出，再传递给后续步骤：

# 包装器工作流接收输出示例
jobs:
  call-main:
    uses: <仓库路径>/.github/workflows/main.yml@main
    outputs:
      received-output: ${{ jobs.call-main.outputs.my-output }}
  use-output:
    runs-on: ubuntu-latest
    needs: call-main
    steps:
      - run: echo "收到的输出: ${{ needs.call-main.outputs.received-output }}"

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