如何为GitHub Actions配置Git用户身份并推送至受保护分支

1. 关于github-actions[bot]类邮箱的疑问 #

是否属于GitHub个人用户账号？ #

这类邮箱不属于个人用户账号，是GitHub官方提供的**github-actions[bot]**专用机器人身份，由GitHub托管，专门用于标识Actions工作流执行的自动化操作。

如何获取并配置用于工作流？ #

不需要额外申请，直接在工作流的Git身份配置步骤中替换即可：

git config --local user.email "github-actions[bot]@users.noreply.github.com"
git config --local user.name "github-actions[bot]"

带ID的格式（如12345678+github-actions[bot]@users.noreply.github.com）是该机器人账号的唯一标识邮箱，使用效果和不带ID的版本一致，可直接替换使用。

组织仓库中使用个人私密邮箱vs机器人账号的区别与配置 #

你提到的ID+USERNAME@users.noreply.github.com是个人账号开启「保持邮箱私密」后生成的私密邮箱，和github-actions[bot]是完全独立的两个身份：

• 若要在组织仓库使用个人私密邮箱，直接在工作流中配置对应邮箱和用户名即可，但会让提交记录关联你的个人身份。
• 使用github-actions[bot]无需邀请其加入组织或授权仓库——工作流默认使用的GITHUB_TOKEN自带仓库操作权限，只要配置正确就能正常执行Git操作，还能清晰区分自动化提交和人工提交。

2. 受保护的develop分支允许工作流推送的配置方法 #

当develop分支开启保护规则后，需要做以下两步配置：

步骤1：让机器人账号绕过分支保护规则 #

进入仓库「设置」→「分支保护规则」，找到对应develop分支的规则：

• 勾选**"允许指定人员绕过所需的拉取请求"**选项
• 在下方的人员/团队输入框中添加github-actions[bot]账号

步骤2：确保工作流拥有足够的推送权限 #

默认的GITHUB_TOKEN权限可能不足，需要在工作流中显式配置：

name: Versioning and Tagging
on:
  push:
    branches:
      - develop

jobs:
  version-and-tagging:
    runs-on: ubuntu-latest
    # 赋予写入仓库内容的权限
    permissions:
      contents: write
    steps:
      - name: Checkout Repository
        uses: actions/checkout@v4
        with:
          persist-credentials: false  # 禁用默认凭证，避免权限冲突

      - name: Set Git User Identity
        run: |
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
          git config --local user.name "github-actions[bot]"

      - name: Bump version
        run: |
          npm version patch

      - name: Push Tag
        run: |
          # 使用GITHUB_TOKEN设置远程仓库地址
          git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git
          git push origin HEAD:develop
          git push origin --tags

如果分支保护规则要求拉取请求审查，上述配置中让机器人绕过规则的步骤是必须的；若不需要审查，也可以直接关闭对应规则，但推荐保留规则并配置绕过权限，兼顾安全和自动化需求。

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