关于重命名分支
您可以重命名 GitHub.com 上仓库中的分支。 有关分支的更多信息,请参阅“关于分支”。
当您在 GitHub.com上重命名分支时,任何包含旧分支名称的网址都会自动重定向到重命名分支的等效 URL。 还更新了分支保护政策以及打开的拉取请求(包括复刻的拉取请求)的基础分支和草稿版本。 重命名完成后, GitHub 在仓库主页上提供说明,指示贡献者更新他们的本地 Git 环境。
虽然文件 URL 会自动重定向,但原始文件 URL 未被重定向。 此外,如果用户对前一个分支名称执行 git pull
,则 GitHub 不会执行任何重定向。
GitHub Actions 工作流不会跟随重命名,因此,如果您的仓库发布某个操作,任何人使用该操作结合 {old-branch-name}
都会崩溃。 您应该考虑添加带有原始内容的新分支,外加一个额外的提交报告,说明分支名称已弃用,并建议用户迁移到新的分支名称。
重命名分支
- 在 GitHub.com 上,导航到仓库的主页面。
- 在文件列表上方,单击 Branches(分支)。
- 在分支列表中,在要重命名的分支的右侧,单击 。
- 为分支输入新名称。
- 查看有关本地环境的信息,然后单击 Rename branch(重命名分支)。
在分支名称更改后更新本地克隆
在您重命名 GitHub 仓库中的分支后,拥有该仓库本地克隆的所有协作者都需要更新克隆。
从计算机上的仓库本地克隆中,运行以下命令以更新默认分支的名称。
$ git branch -m OLD-BRANCH-NAME NEW-BRANCH-NAME
$ git fetch origin
$ git branch -u origin/NEW-BRANCH-NAME NEW-BRANCH-NAME
$ git remote set-head origin -a
(可选)运行下面的命令来删除对旧分支名称的跟踪引用。
$ git remote prune origin