Git无提交内容时抛出错误如何抑制？GitHub Actions CI/CD处理方案

核心原因 #

当Git工作区/暂存区没有任何变更时，git commit命令会返回非零退出码，而GitHub Actions默认会将非零退出码判定为步骤失败，导致流水线中断。

两种可行解决方案 #

方案1：先检查变更，有变更再执行提交 #

通过Git命令判断是否存在待提交的变更，仅在有变更时才执行commit和push操作，避免无变更时触发错误。

在你的GitHub Actions步骤中，替换原有的提交命令为以下脚本：

# 添加所有文件到暂存区
git add .

# 检查暂存区是否有变更，有则执行提交
git diff --cached --quiet || git commit -m "CI: 更新外部仓库文件"

# 只有当commit成功执行（即有变更）时才推送
if [ $? -eq 0 ]; then
  git push
else
  echo "无文件变更，跳过提交推送"
fi

解释：

• git diff --cached --quiet：检查暂存区与HEAD的差异，无差异返回0，有差异返回1
• || 逻辑：只有前面的命令返回非零（即有变更）时，才执行后面的git commit
• 最后通过$?判断commit是否成功，成功才推送，否则输出提示跳过

方案2：允许空提交（不推荐，除非业务需要） #

如果你的场景允许提交空commit（即没有文件变更但需要记录流水线执行），可以给git commit添加--allow-empty参数，这样即使无变更，commit也会成功执行：

git add .
git commit -m "CI: 执行流水线（无文件变更）" --allow-empty
git push

注意：这种方式会在外部仓库生成无内容的commit，可能污染提交历史，仅在特殊场景下使用。

GitHub Actions步骤示例 #

完整的步骤片段大概是这样：

- name: 克隆外部仓库
  run: git clone https://${{ secrets.EXTERNAL_REPO_TOKEN }}@github.com/xxx/xxx.git external-repo

- name: 移入文件到外部仓库
  run: cp -r ./your-files/* external-repo/

- name: 提交并推送变更到外部仓库
  working-directory: ./external-repo
  shell: bash
  run: |
    git config user.name "GitHub Actions Bot"
    git config user.email "actions@github.com"
    git add .
    git diff --cached --quiet || git commit -m "CI: 更新外部仓库文件"
    if [ $? -eq 0 ]; then
      git push
    else
      echo "无文件变更，跳过推送"
    fi

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