GitHub Actions YAML任务跳过逻辑异常求助：参数判断不生效

以下是经过验证的正确配置方案，能确保仅当param4参数值为NOSKIP时才执行main-thread任务：

完整工作流示例 #

name: Conditional Main Task
on:
  workflow_dispatch:
    inputs:
      param4:
        description: '控制是否执行主线任务'
        required: true
        default: 'SKIP'

jobs:
  main-thread:
    runs-on: ubuntu-latest
    # 核心条件：仅当param4等于'NOSKIP'时触发该任务
    if: ${{ github.event.inputs.param4 == 'NOSKIP' }}
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
      
      - name: 执行Python脚本
        run: python your_script.py

关键注意事项 #

• 参数必须通过github.event.inputs.param4引用，不能直接写param4或其他简化写法
• 条件表达式必须包裹在${{ }}中，这是GitHub Actions识别表达式的标准语法
• 字符串比较时引号要统一（单引号或双引号均可），避免YAML解析错误
• 若只需控制单个步骤而非整个任务，可将if移至步骤层级：

  steps:
    - name: 执行Python脚本
      if: ${{ github.event.inputs.param4 == 'NOSKIP' }}
      run: python your_script.py
  

排查要点 #

1. 查看工作流运行日志的「Set up job」阶段，确认github.event.inputs.param4的实际传入值是否正确
2. 检查参数名称param4与workflow_dispatch中定义的输入名称完全一致（大小写敏感）
3. 避免漏写${{ }}直接写条件，否则会被YAML当作普通字符串处理，失去判断作用

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