GitHub Actions优化：无更新时避免提交失败并优雅终止

可以通过两种简洁的方式处理该场景，避免工作流因无内容提交而失败：

方法一：提前检查文件变更再执行提交 #

在提交前先判断目标README文件是否有修改，无变更则直接跳过提交步骤，输出提示后正常结束工作流。

示例作业配置：

jobs:
  push_readme:
    runs-on: ubuntu-latest
    steps:
      - name: 检出代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: 转换README格式
        run: |
          # 替换为你的格式转换命令，比如 pandoc README.md -o README.rst
          pandoc README.md -o README.rst

      - name: 检查文件变更状态
        id: check_change
        run: |
          git diff --quiet README.rst || echo "changed=true" >> $GITHUB_OUTPUT

      - name: 提交并推送变更
        if: steps.check_change.outputs.changed == 'true'
        run: |
          git config --global user.name "GitHub Action"
          git config --global user.email "action@github.com"
          git add README.rst
          git commit -m "Update converted README"
          git push
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: 无变更提示
        if: steps.check_change.outputs.changed != 'true'
        run: echo "⚠️ 没有可提交的README变更，工作流将正常终止"

方法二：捕获commit命令的错误码直接处理 #

如果不想提前检查，可直接执行commit命令，通过临时关闭错误自动终止机制，根据退出码判断是否为无内容提交的情况。

示例提交步骤配置：

- name: 提交并处理无变更场景
        run: |
          git config --global user.name "GitHub Action"
          git config --global user.email "action@github.com"
          git add README.rst
          # 临时关闭错误自动终止
          set +e
          git commit -m "Update converted README"
          COMMIT_EXIT_CODE=$?
          # 恢复错误自动终止
          set -e
          # git无内容提交时退出码为1，单独处理；其他错误仍会触发工作流失败
          if [ $COMMIT_EXIT_CODE -eq 1 ]; then
            echo "⚠️ 没有可提交的README变更，无需推送"
          else
            git push
          fi
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

关键细节说明 #

• git diff --quiet filename：文件无变更时返回0，有变更时返回非0值，通过$GITHUB_OUTPUT将状态传递给后续步骤。
• git commit退出码：无内容可提交时退出码固定为1，其他异常（如权限问题）会返回其他非0值，可精准区分场景。
• GITHUB_TOKEN：利用GitHub内置令牌即可完成仓库推送，无需额外配置个人令牌。

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