GitHub Actions如何通过矩阵变量设置自定义Shell？

问题背景 #

在GitHub Actions的矩阵任务里，需要根据矩阵中的架构变量，为任务步骤指定对应架构的自定义Shell——这类Shell是基于bash的包装脚本（比如bash-armhf），能在foreign chroot环境结合模拟器运行目标架构的原生命令。

矩阵配置示例：

cross_build:
  strategy:
    matrix:
      job:
      - { release: bullseye  , arch: armhf  , ocaml-version: 4.14.0  , publish: true }

尝试直接在shell字段中使用矩阵变量时失败：

shell: bash-${{ matrix.job.arch }} {0}

报错信息：

The workflow is not valid. .github/workflows/CI.yml (Line: mmm, Col: nn): Unrecognized named-value: 'matrix'.

硬编码架构值（如shell: bash-armhf {0}）则可正常运行，核心限制是GitHub Actions的shell字段不支持矩阵变量插值。

解决方案 #

方案1：通用包装脚本+环境变量传递架构信息 #

编写一个通用的bash-wrapper脚本，通过步骤的环境变量传递矩阵中的架构参数：

1. 通用包装脚本逻辑（假设已存在于任务镜像或工作目录）：

#!/bin/bash
# 从环境变量读取目标架构
TARGET_ARCH="$CI_TARGET_ARCH"
# 调用对应架构的专属包装脚本执行命令
bash-$TARGET_ARCH "$@"

2. Workflow步骤配置：

steps:
  - name: 执行交叉编译任务
    shell: bash-wrapper {0}
    env:
      CI_TARGET_ARCH: ${{ matrix.job.arch }}
    run: |
      ocaml --version
      # 此处添加具体的编译/测试命令

方案2：动态调用架构专属脚本（无需修改shell字段） #

直接在run字段中插值矩阵变量，调用对应架构的包装脚本，并通过here-doc传递要执行的命令：

steps:
  - name: 执行交叉编译任务
    run: |
      bash-${{ matrix.job.arch }} << 'EOF'
      ocaml --version
      # 此处添加所有需要在目标架构环境中执行的命令
      EOF

• 使用<< 'EOF'可避免GitHub Actions解析命令中的变量，确保命令原封不动传入目标Shell；
• 若需要将Workflow层面的变量传递到目标环境，可去掉单引号，改用<< EOF，让Workflow先完成变量插值再传递命令。

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