首页/开发/Git 与协作速查/默认分支改名(master → main)

默认分支改名(master → main)

把默认分支改名为 main 类约定:平台侧调整默认分支与保护规则,本地与 CI 脚本同步更新引用。

Git 与协作速查开发更新于 2026-10-12
平台侧修改默认分支、保护规则与流水线触发
本地侧改名并重设跟踪关系
清单检索脚本、徽章、模板中的旧分支名

本地同步示例

本地同步示例
git branch -m master main
git fetch origin
git branch -u origin/main main
git remote set-head origin -a
改名影响面广(保护规则、触发器、文档、镜像),先列清单再执行、分批通知。

易错点

  • 旧克隆的本地 master 不会自动跟随,通知里附上同步命令省去大量询问
  • 引用旧分支名的脚本与徽章要全局检索替换,遗漏会静默失效

数据来源与参考

  • GitHub 官方文档:重命名默认分支
  • GitLab 官方文档:默认分支设置
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌