GitHub Actions中shell for循环仅执行一次即终止的问题

开发者阿泽

2026-8-29

问题原因

该问题由多个环境差异和shell语法特性共同导致：

GitHub Actions 官方Ubuntu运行环境的默认/bin/sh为dash，是严格遵循POSIX标准的轻量shell，不支持Bash独有的大括号扩展语法{1..3}。脚本中for run in {1..3}的写法在dash环境下不会被展开为1、2、3三个迭代值，只会被识别为单个字面量字符串{1..3}，因此循环本身仅会执行1次。
本地环境可正常运行3次循环，是因为多数桌面Linux发行版、macOS的/bin/sh默认软链接到Bash，Bash即使运行在POSIX兼容模式下，也默认开启大括号扩展特性，和GitHub Actions的默认shell行为不一致。
日志中仅出现1次date输出、看似执行完第一条命令就终止，是因为sleep 1命令本身无任何输出，1次循环执行完date、等待1秒后流程直接结束，造成了提前终止的错觉。
默认sh -e参数开启了“任意命令返回非0退出码即终止整个脚本”的规则，若后续在循环中运行基准测试命令，单轮测试返回非0值时会直接中断整个脚本，无法跑完预设循环次数，是这类批量执行脚本的常见隐患。

注：日志中显示PIP_EXTRA_INDEX_URL值包含空格，后续脚本中引用该变量时需要用双引号包裹（即"$PIP_EXTRA_INDEX_URL"），避免shell按空格拆分值引发命令参数错误。

修复方案

选择任意一种方案即可解决问题：

方案1：显式指定使用Bash执行步骤，和本地测试环境行为对齐，改动成本最低。可在对应步骤中添加shell: bash字段，也可在Job层级配置全局默认shell：

- name: run a loop
  shell: bash
  run: |
    for run in {1..3}; do
      date
      sleep 1
    done

方案2：若需要兼容POSIX标准sh，可将循环改为POSIX兼容写法，避免使用Bash独有的大括号扩展。比如通过seq生成迭代序列：

- name: run a loop
  run: |
    for run in $(seq 1 3); do
      date
      sleep 1
    done

循环次数较少时也可直接显式枚举迭代值：

- name: run a loop
  run: |
    for run in 1 2 3; do
      date
      sleep 1
    done

方案3：针对-e参数导致的单轮失败即中断全局的问题，可在循环体内可能返回非0退出码的命令后追加|| true，保证单轮执行失败不会打断整体循环流程，示例如下：

- name: run benchmark loop
  shell: bash
  run: |
    for run in {1..3}; do
      echo "Running benchmark round $run"
      ./your-benchmark-binary || true
      sleep 1
    done

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