修改分支名称
如果你想将 GitHub 仓库的默认分支从 master改为 main。
·
如果你想将 GitHub 仓库的默认分支从 master 改为 main,可以按照以下步骤操作:
1. 在本地仓库创建 **main 分支**
# 进入项目目录
cd your-repo
# 确保当前在 master 分支
git checkout master
# 基于 master 创建 main 分支
git branch -m master main
-m表示重命名分支(master→main)。
2. 推送 **main 分支到 GitHub**
# 推送 main 分支到远程(GitHub)
git push -u origin main
-u设置main为默认推送分支。
3. 修改 GitHub 仓库的默认分支
- 进入 GitHub 仓库页面,点击 Settings → Branches。
- 在 Default branch 下拉菜单中,选择
main,点击 Update。 - 确认更改(可能需要输入密码)。
4. 删除远程的 **master 分支(可选)**
# 删除远程的 master 分支
git push origin --delete master
- 如果不再需要
master分支,可以删除以避免混淆。
5. 更新本地仓库的远程跟踪分支
# 拉取最新变更(同步远程 main 分支)
git fetch origin
# 设置本地 main 分支跟踪远程 main 分支
git branch --set-upstream-to=origin/main main
6. 检查是否切换成功
git branch -a
输出应显示:
* main
remotes/origin/main
*表示当前分支是main。remotes/origin/main表示远程main分支已同步。
注意事项
-
协作仓库:
- 如果其他人正在使用
master分支,提前通知他们切换到main。 - 更新 CI/CD 脚本(如 GitHub Actions、Travis CI)中的分支名称。
- 如果其他人正在使用
-
历史记录保留:
- 重命名分支不会影响提交历史,
main和master的 commit 记录完全一致。
- 重命名分支不会影响提交历史,
-
GitHub 自动重定向:
- 即使删除
master,GitHub 会自动将旧的master链接重定向到main。
- 即使删除
为什么推荐使用 **main?**
- GitHub 从 2020 年开始推荐使用
main作为默认分支(更中性化,避免master的潜在争议)。 - 新创建的 GitHub 仓库默认分支已经是
main。
更多推荐

所有评论(0)