无需Web界面，自动化完成Git分支重命名及远程master删除

要在无头服务器上批量/自动化完成这个操作，核心是先通过API修改默认分支、移除分支保护，再执行删除命令。以下是两种可行方案：

方案一：使用GitHub CLI（gh，推荐） #

GitHub CLI是官方工具，语法简洁，适合脚本集成。

前置准备 #

• 已在无头服务器上安装并配置GitHub CLI：通过环境变量GH_TOKEN设置拥有repo权限的个人访问令牌，无需交互式登录。
• 已完成本地分支重命名，且远程main分支已推送同步。

执行步骤 #

1. 修改仓库默认分支为main

   gh repo edit --default-branch main <用户名>/<仓库名>
   

2. 移除master分支的保护规则
   先确认master的保护规则存在，再删除：

   # 可选：查看当前master分支的保护配置
   gh api repos/<用户名>/<仓库名>/branches/master/protection
   # 删除保护规则
   gh api repos/<用户名>/<仓库名>/branches/master/protection -X DELETE
   

3. 删除远程master分支

   git push origin --delete master
   

方案二：使用GitHub REST API（适合自定义脚本） #

如果无法使用GitHub CLI，直接调用REST API也能实现，灵活性更高。

前置准备 #

• 准备拥有repo权限的个人访问令牌，通过环境变量传递（如TOKEN）。
• 定义环境变量简化命令：

  export OWNER="<用户名>"
  export REPO="<仓库名>"
  export TOKEN="<你的个人访问令牌>"
  

执行步骤 #

1. 修改默认分支为main

   curl -X PATCH \
     -H "Authorization: token $TOKEN" \
     -H "Accept: application/vnd.github.v3+json" \
     https://api.github.com/repos/$OWNER/$REPO \
     -d '{"default_branch":"main"}'
   

2. 移除master分支的保护规则

   curl -X DELETE \
     -H "Authorization: token $TOKEN" \
     -H "Accept: application/vnd.github.v3+json" \
     https://api.github.com/repos/$OWNER/$REPO/branches/master/protection
   

3. 删除远程master分支

   git push origin --delete master
   

关键注意事项 #

• 必须先修改默认分支：GitHub不允许删除当前默认分支，这是你之前执行git push --delete报错的核心原因。
• 令牌权限：确保个人访问令牌拥有repo范围权限，组织仓库可能需要额外的管理员权限。
• 历史保留：题目已确认前置检查完成，确保main分支完全同步了master的所有提交历史，不会丢失数据。

内容的提问来源于stack exchange，提问作者K. W. Cooper