如何在GitHub工作流中无视前置步骤结果，仅按文件存在性执行步骤？

问题描述 #

需要实现一个GitHub Actions工作流，完全基于文件是否存在来执行某一步骤，不受前置步骤成功或失败的影响，要覆盖以下四种场景：

• 文件存在且前置步骤执行成功
• 文件不存在且前置步骤执行成功
• 文件存在且前置步骤执行失败
• 文件不存在且前置步骤执行失败

尝试用hashFiles函数判断文件存在性，但发现不管条件写hashFiles('xxx') != ''还是== ''，目标步骤都会执行，只有设置if: false时才会停止，完全达不到预期效果。

核心原因 #

GitHub Actions的hashFiles函数是在**工作流初始化阶段（编译时）**执行的，它只能检测工作流触发时仓库中已有的文件，无法识别步骤运行过程中动态创建的文件。这就是为什么判断逻辑完全失效——hashFiles在步骤运行前就已经计算好了结果，根本没用到你动态生成的文件。

正确实现方案 #

要检测步骤中动态生成的文件，必须用shell命令直接判断，同时配合always()确保步骤不受前置成功/失败状态影响，具体有两种实现方式：

方式一：直接在步骤中判断文件并执行逻辑 #

这种方式把文件判断和业务逻辑放在同一个步骤里，简单直接：

- name: 前置步骤（可能成功或失败）
  continue-on-error: true  # 强制工作流继续执行后续步骤
  run: |
    echo "test content" > target-file.xml
    exit 1  # 这里模拟前置步骤失败

- name: 根据文件存在性执行逻辑
  if: always()  # 不管前置步骤状态如何，都运行此步骤
  run: |
    if [ -f "target-file.xml" ]; then
      echo "文件存在，执行核心逻辑"
      # 在这里写你的业务代码
    else
      echo "文件不存在，跳过逻辑"
    fi

方式二：先输出文件存在状态，再通过步骤输出控制后续执行 #

这种方式更清晰，适合需要在多个步骤中复用文件存在状态的场景：

- name: 前置步骤（可能成功或失败）
  id: pre-step
  continue-on-error: true
  run: |
    echo "test content" > target-file.xml
    exit 1

- name: 检测文件是否存在
  id: check-file
  if: always()
  run: |
    if [ -f "target-file.xml" ]; then
      echo "exists=true" >> "$GITHUB_OUTPUT"
    else
      echo "exists=false" >> "$GITHUB_OUTPUT"
    fi

- name: 仅当文件存在时执行此步骤
  if: steps.check-file.outputs.exists == 'true'
  run: |
    echo "文件存在，执行专属逻辑"

覆盖所有四种场景的完整测试工作流 #

name: 文件存在性测试工作流
on:
  workflow_dispatch:

jobs:
  test-scenarios:
    runs-on: ubuntu-latest
    steps:
      # 场景1：文件存在 + 前置步骤成功
      - name: 创建文件并成功退出
        id: success-create
        run: |
          echo "success" > success-file.xml
          exit 0

      - name: 检测success-file.xml（预期执行）
        if: always()
        run: |
          if [ -f "success-file.xml" ]; then
            echo "✅ success-file.xml 存在"
          else
            echo "❌ success-file.xml 不存在"
            exit 1
          fi

      # 场景2：文件不存在 + 前置步骤成功
      - name: 仅成功退出，不创建文件
        id: success-no-file
        run: exit 0

      - name: 检测non-exist-success.xml（预期不执行核心逻辑）
        if: always()
        run: |
          if [ -f "non-exist-success.xml" ]; then
            echo "❌ non-exist-success.xml 不该存在"
            exit 1
          else
            echo "✅ non-exist-success.xml 不存在，跳过逻辑"
          fi

      # 场景3：文件存在 + 前置步骤失败
      - name: 创建文件并失败退出
        id: fail-create
        continue-on-error: true
        run: |
          echo "fail" > fail-file.xml
          exit 1

      - name: 检测fail-file.xml（预期执行）
        if: always()
        run: |
          if [ -f "fail-file.xml" ]; then
            echo "✅ fail-file.xml 存在"
          else
            echo "❌ fail-file.xml 不存在"
            exit 1
          fi

      # 场景4：文件不存在 + 前置步骤失败
      - name: 仅失败退出，不创建文件
        id: fail-no-file
        continue-on-error: true
        run: exit 1

      - name: 检测non-exist-fail.xml（预期不执行核心逻辑）
        if: always()
        run: |
          if [ -f "non-exist-fail.xml" ]; then
            echo "❌ non-exist-fail.xml 不该存在"
            exit 1
          else
            echo "✅ non-exist-fail.xml 不存在，跳过逻辑"
          fi

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