Github Actions：如何快速失败并显示自定义错误信息？

可以实现，无需拆分步骤，以下是几种优雅的解决方式：

• 脚本内输出错误后退出
  在版本标签检查脚本中，先输出自定义错误提示，再执行退出命令，确保错误信息被捕获并展示：

  #!/bin/bash
  # 检查目标版本标签是否存在
  if ! git tag | grep -q "^v$TARGET_VERSION$"; then
    echo "::error::指定版本 $TARGET_VERSION 不存在，请确认版本标签！"
    exit 1
  fi
  

  调用该脚本的步骤会在执行详情中显示错误提示，同时触发工作流快速失败。

• 步骤内直接编写逻辑
  若无需单独脚本，可在Actions步骤中直接嵌入命令逻辑，同样能实现需求：

  steps:
    - name: 检查版本标签
      run: |
        if ! git tag | grep -q "^v$TARGET_VERSION$"; then
          echo "::error::指定版本 $TARGET_VERSION 不存在，请确认版本标签！"
          exit 1
        fi
      env:
        TARGET_VERSION: ${{ inputs.version }}
  

  工作流默认开启fail-fast（全局fail-fast参数默认值为true），该步骤失败后会立即终止整个工作流，错误提示会显示在对应步骤的执行详情里。

• 关键注意事项

  • 避免随意重定向脚本的标准输出/错误流，否则可能导致::error::格式的提示无法被Actions识别。
  • 若脚本中启用了set -e（快速失败模式），需确保echo错误提示的命令在exit 1之前执行，set -e不会中断成功的echo命令执行。

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