GitHub build-push-action的GHA缓存Scope设置：是否需包含分支名？

我正在使用docker/build-push-action@v4结合GitHub Actions缓存构建多个Docker镜像，例如foo/bar:latest、foo/bar:2.8，工作流中的env.tag变量为带标签的完整镜像名。

根据官方文档描述：

默认情况下，缓存按Git分支划分作用域，确保主分支和每个功能分支拥有独立的缓存环境。若在同一分支构建多个镜像，每次构建都会覆盖之前的缓存，仅保留最终缓存。

我希望确认缓存的正确配置方式：仅将env.tag作为scope是否可行？GitHub缓存是否仍会按文档所述使用分支隔离，还是需要传入${{ github.ref_name }}-${{ env.tag }}作为scope？

对应的工作流代码片段如下：

- name: Build and push
      uses: docker/build-push-action@v4
      env:
        tag: "${{ env.image }}:${{ matrix.version }}"
      with:
        context: "{{defaultContext}}:docker/caddy"
        target: ${{ matrix.target }}
        push: ${{ github.event_name != 'pull_request' }}
        tags: ${{env.tag }}
        build-args: |
          BASE_IMAGE=${{ matrix.version }}
        cache-from: type=gha,scope=${{ env.tag }}
        cache-to: type=gha,mode=max,scope=${{ env.tag }}

解答 #

1. 仅用env.tag作为scope不可行
   当你显式指定scope参数时，会直接覆盖GHA缓存默认的分支隔离逻辑。这意味着不同分支下的同名镜像（比如多个分支都构建foo/bar:latest）会共享同一缓存池，极易引发缓存污染，破坏分支间的缓存隔离性。

2. 推荐使用${{ github.ref_name }}-${{ env.tag }}作为scope
   这种组合方式能同时满足两个核心需求：

   • 同一分支下，不同镜像的缓存相互独立，不会出现构建时互相覆盖的问题；
   • 不同分支之间的缓存仍然保持隔离，避免跨分支的缓存干扰。

3. 原理补充
   GHA缓存的默认scope是当前分支名，这能保证分支间隔离，但同一分支多镜像构建会覆盖缓存；而显式组合分支名与镜像标签作为scope，相当于给每个分支下的每个镜像都创建了独立的缓存空间，完美适配你的多镜像构建场景。

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