如果你想将 GitHub 仓库的默认分支从 master 改为 main,可以按照以下步骤操作:

1. 在本地仓库创建 ​​**main​ 分支**

# 进入项目目录
cd your-repo

# 确保当前在 master 分支
git checkout master

# 基于 master 创建 main 分支
git branch -m master main
  • -m 表示重命名分支(mastermain)。

2. 推送 ​​**main​ 分支到 GitHub**

# 推送 main 分支到远程(GitHub)
git push -u origin main
  • -u 设置 main 为默认推送分支。

3. 修改 GitHub 仓库的默认分支

  1. 进入 GitHub 仓库页面,点击 SettingsBranches
  2. Default branch 下拉菜单中,选择 main,点击 Update
  3. 确认更改(可能需要输入密码)。

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 分支已同步。

注意事项

  1. 协作仓库

    • 如果其他人正在使用 master 分支,提前通知他们切换到 main
    • 更新 CI/CD 脚本(如 GitHub Actions、Travis CI)中的分支名称。
  2. 历史记录保留

    • 重命名分支不会影响提交历史,mainmaster 的 commit 记录完全一致。
  3. GitHub 自动重定向

    • 即使删除 master,GitHub 会自动将旧的 master 链接重定向到 main

为什么推荐使用 ​​**main?**

  • GitHub 从 2020 年开始推荐使用 main 作为默认分支(更中性化,避免 master 的潜在争议)。
  • 新创建的 GitHub 仓库默认分支已经是 main
Logo

欢迎加入DeepSeek 技术社区。在这里,你可以找到志同道合的朋友,共同探索AI技术的奥秘。

更多推荐