为何GitHub Actions Shell中变量为0时无法使用let或((++))？

问题现象 #

在GitHub Action使用ubuntu-latest默认的bash 5.1.11时，遇到以下与本地bash 5.1.12不一致的行为：

• 执行let my_var=0会以退出码1失败，但let my_var=42可正常运行
• 当变量my_var初始值为0时，执行((my_var++))会以退出码1失败，但初始值为42时可正常运行

示例GitHub Action配置 #

name: Test shell
on:
  workflow_dispatch:

jobs:
  test-shell:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Increment variable
        run: |
          let my_var=3
          echo "::notice::my_var is $my_var"
          ((my_var++))
          echo "::notice::my_var is now $my_var"

      - name: FAIL - Set variable to 0 using let
        if: false
        run: |
          echo "::notice::Preparing to initialize variable to 0"
          let my_var=0
          echo "::notice::my_var is $my_var"

      - name: Set variable to 0
        run: |
          echo "::notice::Preparing to initialize variable to 0"
          my_var=0
          echo "::notice::my_var is $my_var"

      - name: FAIL - Increment variable from 0 using ((++))
        if: false
        run: |
          echo "::notice::my_var is $my_var"
          ((my_var++))
          echo "::notice::my_var is now $my_var"

      - name: Increment variable from 0 using +=
        run: |
          my_var=0
          echo "::notice::my_var is $my_var"
          let my_var+=1
          echo "::notice::my_var is now $my_var"

原因与解决方案 #

原因 #

bash的let和((...))会将表达式的求值结果作为退出码：当表达式结果为0时，退出码返回1（表示失败）；结果为非0时，退出码返回0（表示成功）。GitHub Action的run步骤默认会严格检查每个命令的退出码，一旦非0就判定步骤失败。本地测试时可能未开启类似的严格检查，因此未触发失败。

解决方案 #

可以通过以下方式避免此类失败：

• 初始化0值时直接用赋值语句替代let：my_var=0
• 执行let或((...))时显式忽略退出码：
  • let my_var=0 || true
  • ((my_var++)) || true
• 暂时关闭严格退出检查：在脚本开头添加set +e，完成操作后再恢复set -e

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