修改本地 Git 的全局默认分支名称

在终端运行以下命令，设置 main 为未来所有新仓库的默认分支：

1

git config --global init.defaultBranch main

验证配置是否生效：

1

git config --global init.defaultBranch  # 应输出 `main`

修改现有本地仓库的主分支名称

如果已有本地仓库仍在使用 master，需手动重命名分支：

1

git branch -m master main  # 将本地分支从 master 重命名为 main

更新远程仓库（如 GitHub）

情况1：远程仓库允许修改默认分支

1. 推送 main 分支到远程：

   1	git push -u origin main

2. 在远程仓库设置中将 main 设为默认分支：

   • GitHub: Settings → General → Default branch → 选择 main → 点击 Update。

3. 删除远程的 master 分支（可选）：

   1	git push origin --delete master

情况2：远程仓库不允许直接修改（如权限限制）

联系仓库管理员或按照团队流程提交分支修改请求。

同步其他协作者的本地仓库

通知协作者运行以下命令更新其本地分支：

1
2
3
4

git fetch origin
git branch -m master main           # 重命名本地分支
git branch -u origin/main main      # 关联本地 main 到远程 main
git remote set-head origin -a       # 更新远程 HEAD 引用

验证修改是否成功

• 检查本地分支：

  1	git branch -a # 应显示 `main` 而非 `master`

• 检查远程默认分支：

  1	git remote show origin # 查看 HEAD branch 是否为 `main`