如何在GitHub Actions多操作系统矩阵中仅为Linux启用Docker容器？

问题背景 #

GitHub Actions支持通过作业矩阵在多操作系统上运行同一作业的多个变体，示例配置如下：

name: Build
on:
  push:
    branches: [ main ]
jobs:
  build:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - (…)

同时，Linux运行器支持使用Docker容器运行作业，示例配置：

name: Build
on:
  push:
    branches: [ main ]
jobs:
  build:
    runs-on: ubuntu-latest
    container: my-docker/container:0.1.0
    steps:
      - (…)

需要实现的需求是：通过矩阵在多操作系统上运行作业，仅为Linux启用Docker容器，macOS作业直接在运行器执行。但直接在container字段添加if关键字的写法无效（container字段不支持if条件），去掉if则macOS运行器会因无法加载Docker容器而失败。

解决方案 #

可以利用GitHub Actions矩阵的include特性，为不同操作系统配置对应的容器参数，实现条件化启用容器：

方案1：默认空容器+针对性覆盖 #

name: Build
on:
  push:
    branches: [ main ]
jobs:
  build:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest]
        # 为所有系统初始化container字段为null
        container: [null]
        include:
          # 仅为ubuntu-latest指定容器镜像
          - os: ubuntu-latest
            container: my-docker/container:0.1.0
    runs-on: ${{ matrix.os }}
    # 当container为null时，GitHub Actions会忽略该配置
    container: ${{ matrix.container }}
    steps:
      - (…)

方案2：直接定义每个系统的完整配置 #

name: Build
on:
  push:
    branches: [ main ]
jobs:
  build:
    strategy:
      matrix:
        include:
          # 为Linux指定容器配置
          - os: ubuntu-latest
            container: my-docker/container:0.1.0
          # macOS不启用容器
          - os: macos-latest
            container: null
    runs-on: ${{ matrix.os }}
    container: ${{ matrix.container }}
    steps:
      - (…)

原理说明 #

• 当container字段的值为null时，GitHub Actions会自动忽略容器配置，作业直接在指定的运行器上执行。
• 通过矩阵的include特性，仅为ubuntu-latest系统设置有效的容器镜像，从而实现Linux作业启用容器、macOS作业不启用的目标。

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