如何在GitHub Action中优化main或指定分支的条件检出，避免双重检出？

直接完整克隆仓库，本地判断分支 #

你可以调整actions/checkout的参数，一次性克隆包含所有分支的完整仓库，这样就能在本地直接检测目标分支是否存在，不用先检出main再远程判断，避免双重checkout操作。

具体操作步骤 #

• 配置checkout动作时加上fetch-depth: 0参数，拉取完整仓库：

  - name: 完整克隆仓库
    uses: actions/checkout@v4
    with:
      fetch-depth: 0  # 拉取完整仓库历史及所有分支
      ref: main
  

• 用git命令本地检测分支是否存在，再做对应处理：

  TARGET_BRANCH="你的目标分支名"
  # 检查本地是否已有该分支
  if git show-ref --verify --quiet refs/heads/$TARGET_BRANCH; then
    git checkout $TARGET_BRANCH
  else
    # 从main分支创建新分支
    git checkout -b $TARGET_BRANCH
  fi
  

• 之后就可以正常执行文件变更、提交、创建PR的流程了

关键说明 #

fetch-depth: 0是核心，它会让checkout拉取仓库的全部历史和所有远程分支，之后本地就能直接通过git命令判断分支状态，不需要再额外发起远程请求或二次检出。只要Action使用的token有仓库读写权限，克隆后就能直接操作所有分支，不用依赖先检出main来获取权限。

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