如何获取GitHub Actions当前步骤编号以生成对应日志链接

截至目前GitHub Actions确实没有提供内置的上下文变量或者环境变量来直接获取当前步骤的编号，硬编码步骤编号确实会因为后续步骤增减出现指向错误的问题。以下是两种可落地的实现方案：

方案1：调用GitHub REST API查询步骤编号 #

你可以给目标步骤设置自定义id，之后在步骤内调用GitHub的运行时API查询当前工作流run对应的所有步骤，匹配到对应id的步骤后提取其number字段，再拼接日志URL即可。
示例实现：

steps:
  - id: target_step
    name: 要生成日志链接的目标步骤
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
    run: |
      # 查询当前run的所有步骤信息
      steps=$(curl -H "Authorization: token $GITHUB_TOKEN" \
        "https://api.github.com/repos/${{ github.repository }}/actions/runs/${{ github.run_id }}/jobs" | jq '.jobs[0].steps')
      # 匹配当前步骤获取编号，可按name匹配也可按其他唯一字段匹配
      step_number=$(echo $steps | jq '.[] | select(.name == "要生成日志链接的目标步骤") | .number')
      # 拼接日志URL
      log_url="https://github.com/${{ github.repository }}/runs/${{ github.run_id }}?check_suite_focus=true#step:$step_number:1"
      echo "当前步骤日志URL: $log_url"

如果你的工作流包含多个job，需要调整jq规则匹配当前job的信息，避免匹配错误。

方案2：使用文本锚点免编号实现跳转 #

如果不想调用API，可以使用浏览器自带的文本片段锚点功能实现稳定跳转，不需要依赖步骤编号，即使后续调整步骤顺序也不会失效：

1. 在目标步骤的最开头输出一段全局唯一的标识字符串，建议包含步骤id和运行尝试次数避免重复
2. 拼接日志URL时直接带上文本锚点参数，访问时会自动滚动到标记所在的位置
   示例实现：

steps:
  - id: target_step
    name: 目标步骤
    run: |
      # 输出唯一标记
      echo "STEP_MARKER_${{ steps.target_step.id }}_${{ github.run_attempt }}"
      # 编码标记内容并拼接带文本锚点的URL
      marker_encoded=$(echo "STEP_MARKER_${{ steps.target_step.id }}_${{ github.run_attempt }}" | jq -Rr @uri)
      log_url="https://github.com/${{ github.repository }}/runs/${{ github.run_id }}?check_suite_focus=true#:~:text=$marker_encoded"
      echo "当前步骤日志URL: $log_url"

关于通过步骤id直接链接日志块的问题 #

目前GitHub官方没有提供用自定义步骤id直接生成日志锚点的原生支持，上述两个方案是目前社区最常用的替代实现。

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