GitHub Action能否获取uses字段中@符号后指定的版本标识？

实现方案 #

这个需求没有官方的直接内置变量可以在action.yml的runs.image字段直接动态取值，但可以通过两种成熟的方案实现：

方案1：发布阶段静态替换版本号（最常用）

你可以在Action仓库的CI流程中，给代码打标签/推送到分支时，自动将action.yml中的镜像tag占位符替换为对应的标签/分支名，再发布对应版本的Action。
示例流程：

1. 你在action.yml里预先留好占位符：

runs:
  using: 'docker'
  image: 'docker://some_url_to_image:{{VERSION_PLACEHOLDER}}'

2. 配置仓库的GitHub Actions工作流，监听tag推送和main分支推送事件：

• 当推送v1标签时，自动将{{VERSION_PLACEHOLDER}}替换为v1，然后提交/打包到对应的tag版本中
• 当推送到main分支时，自动将占位符替换为main，更新分支内的action.yml

这种方案的优势是运行时无额外开销，逻辑简单稳定，绝大多数官方Action都采用这种实现方式。

方案2：运行时动态获取版本号

如果你不想在发布阶段做替换，可以修改Action的运行时类型，把镜像拉取逻辑放到执行脚本里动态处理：

1. 将action.yml的运行时改为composite类型，不再直接声明docker镜像
2. 在执行步骤中通过git命令获取当前Action代码的版本标识：

runs:
  using: "composite"
  steps:
    - id: get-version
      shell: bash
      run: |
        # 获取当前标签，没有标签则取当前分支名
        VERSION=$(git describe --tags --exact-match 2>/dev/null || git rev-parse --abbrev-ref HEAD)
        echo "version=$VERSION" >> $GITHUB_OUTPUT
    - name: Run docker image
      shell: bash
      run: docker run docker://some_url_to_image:${{ steps.get-version.outputs.version }}

这种方案灵活性更高，不需要修改发布流程，但是会增加少量运行时耗时。

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