Git 删除远程主分支（默认分支）

场景

删除远程 main 分支

关键步骤

1. 更改远程默认分支

必须先在 GitHub 网页端操作：

• Settings → Default branch → 选择新分支 → Update

2. 同步本地远程跟踪

git remote set-head origin -a

3. 验证更改

git remote show origin
# 确认 HEAD branch 已变更

4. 删除远程分支

git push origin --delete main

5. 清理本地引用（可选）

git remote prune origin

重要提示

• main 分支通常受保护，必须先改默认分支才能删除
• git remote show origin 显示的 HEAD branch 是真实的服务器端默认分支
• 本地的 remotes/origin/HEAD 只是缓存，可能不准确

关于 git remote set-head 命令

git remote set-head origin <branch> 的局限性

** 只影响（本地）：**

• 更新本地对远程 HEAD 的缓存引用
• git branch -a 显示的 remotes/origin/HEAD 指向
• 使用 origin 简写时的默认分支（如 git diff origin）

** 不影响（服务器端）：**

• 远程服务器的实际默认分支
• GitHub/GitLab 网页上显示的默认分支
• 其他人 clone 时获取的默认分支
• 分支保护规则

验证方式对比

命令	显示内容	准确性
git branch -a	本地缓存的 HEAD	可能过时
git remote show origin	服务器真实的 HEAD	准确

结论

• git remote set-head origin <branch> - 只改本地缓存，无法改变服务器设置
• git remote set-head origin -a - 从服务器自动同步正确的 HEAD
• 要真正改变默认分支，必须在 GitHub 网页端操作

常用命令

git branch -a                    # 查看所有分支
git remote show origin           # 查看远程仓库详情（权威）
git push origin --delete 分支名   # 删除远程分支
git push origin :分支名           # 删除远程分支（旧语法）
git remote set-head origin -a    # 自动同步远程 HEAD