Git 初始化仓库的默认分支名由配置项 init.defaultBranch 决定，2.28+ 版本全局默认为 main；可通过 git config --global init.defaultBranch main 永久修改，已有仓库需手动切换分支并更新远程平台默认设置。
Git 初始化仓库时怎么设默认分支名
新仓库的默认分支名由 Git 全局配置 init.defaultBranch 决定，不是硬编码的 master。Git 2.28+ 默认已改为 main，但老版本或手动升级的用户很可能还是 master。
执行这条命令就能永久改掉：
git config --global init.defaultBranch main
之后所有 git init 新建的本地仓库，默认分支就是 main。注意：这不影响已有仓库，也不影响远程仓库（比如 GitHub 上已存在的 master 分支）。
- 如果只想改当前项目，去掉
--global，用git config init.defaultBranch main - 想确认当前值？运行
git config init.defaultBranch（查本地）或git config --global init.defaultBranch（查全局） - 某些 CI/CD 工具或脚本会硬写
master，改完这里还得同步检查它们
已存在的本地仓库如何把 master 改成 main
这不是“重命名”，而是创建新分支 + 删除旧分支。Git 不提供直接重命名默认分支的原子操作，尤其当它被设为 HEAD 时。
步骤很直白，但顺序不能错：
- 确保你在
master分支上：git checkout master - 基于它新建
main分支：git branch -m master main（-m是 move，本质是重命名） - 把本地
HEAD指向新分支：git symbolic-ref HEAD refs/heads/main - 更新
origin的默认跟踪分支（如果已关联）：git branch --set-upstream-to=origin/main main
⚠️ 常见错误：只跑 git branch -m master main 就以为完事了。此时 HEAD 还指向原 master 引用，下次 git status 会报错或行为异常。
怎么让远程仓库（GitHub/GitLab）也认 main 为默认分支
本地改完只是第一步。远程平台有自己的“默认分支”设置，必须单独改，否则 git push --set-upstream origin main 成功后，克隆这个仓库的人依然会拿到 master（如果平台没更新设置）。
操作不在命令行里，在网页后台：
-
GitHub：Settings → Branches → Default branch → 点右边铅笔图标 → 选
main→ Save -
GitLab：Settings → Repository → Default branch → 下拉选
main→ Save changes - 自建 Git 服务器（如 Gitea）：同样在仓库设置页找 “Default Branch” 字样
改完之后，新 clone 的人就会自动检出 main，git pull 也会默认追踪它。但注意：已有 clone 的用户不会自动切换，得自己 git checkout main 并 git branch --set-upstream-to=origin/main main。
为什么 git push 时提示 refspec 错误或拒绝删除 master
这是最常卡住人的地方：远程默认分支被保护，或权限不足，导致 git push origin --delete master 失败。
典型错误信息：! [remote rejected] master (refusing to delete the current branch: refs/heads/master)
原因和解法都很具体：
- 远程默认分支仍是
master→ 先去平台后台把它改成main（见上一节） - 远程分支受保护（如 GitHub 的 branch protection rules）→ 进入 Settings → Branches → Branch protection rules → 找到
master规则 → 编辑或删掉它 - 你没有删除分支权限 → 联系仓库管理员，或确认你是 owner / admin
真正安全删掉远程 master 的时机，一定是：平台默认分支已切到 main，且 master 无保护规则、无强依赖（比如 CI 配置还指它）。
改默认分支看着是 rename 一个名字，实际牵扯本地配置、HEAD 指针、远程设置、平台保护策略、下游协作工具——漏掉任意一环，都可能让别人 git clone 后卡在奇怪的地方。
