如何永久设置GitHub仓库的默认分支？

排查&操作步骤 #

• 确认操作权限
  你必须拥有仓库的管理员或所有者权限才能修改默认分支，仅有写入权限的账户提交的修改请求会被后台直接驳回，不会报错但修改不会持久化。如果是组织托管的仓库，需要联系组织管理员为你开通仓库设置修改权限，或直接让管理员完成默认分支修改操作。
• 检查分支规则冲突
  进入仓库Settings→Branches页面：
  1. 查看是否有分支保护规则限制test分支被设为默认分支
  2. 确认组织层面没有全局规则强制要求仓库默认分支必须为main
     如有相关限制，先调整规则允许切换默认分支，修改完成后再按需还原规则即可。
• 完整执行修改全流程
  很多用户会漏过二次确认步骤导致修改未生效，正确完整流程如下：
  1. 在Default branch板块点击右侧的切换按钮
  2. 下拉列表选中test分支后点击Update按钮
  3. 在弹出的风险提示窗口中，按照提示输入仓库全名完成二次确认，必须完成本步骤修改才会写入配置。
• 规避缓存干扰验证结果
  修改完成后不要用当前已登录的浏览器直接刷新验证，打开浏览器无痕模式访问仓库地址，此时展示的默认分支就是最终生效的配置，避免原有浏览器的页面缓存、账户缓存展示旧状态。
• 本地仓库同步配置
  所有本地克隆该仓库的开发者需要执行以下命令同步远程默认分支变更，避免后续推送操作意外回退远程配置：

  git fetch origin
  git remote set-head origin test
  

以上操作完成后默认分支修改就会永久生效，且不会影响你保留main、qa、test三个分支的需求。

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