跳至主要内容

重命名分支

您可以更改仓库中分支的名称。

谁可以使用此功能?

拥有仓库写入权限的人员可以重命名仓库中的分支,除非它是 默认分支受保护的分支。拥有管理员权限的人员可以重命名默认分支和受保护的分支。

关于重命名分支

您可以在 GitHub.com 上重命名仓库中的分支。有关分支的更多信息,请参阅“关于分支”。

当您在 GitHub.com 上重命名分支时,任何包含旧分支名称的 URL 都会自动重定向到重命名分支的等效 URL。分支保护策略也会更新,以及开放拉取请求(包括分叉的拉取请求)和草稿版本的基分支。如果重命名的分支是开放拉取请求的头部分支,则此拉取请求将关闭。

如果仓库的默认分支被重命名,GitHub 会在仓库主页上提供指示,指导贡献者更新其本地 Git 环境。

虽然文件 URL 会自动重定向,但原始文件 URL 不会重定向。此外,如果用户对旧分支名称执行 `git pull` 操作,GitHub 不会执行任何重定向。

GitHub Actions 工作流程不会跟踪重命名,因此,如果您的仓库发布了某个 Action,任何使用 `@{old-branch-name}` 的用户都会遇到问题。您应该考虑添加一个新分支,其中包含原始内容以及一个额外的提交,报告该分支名称已弃用,并建议用户迁移到新分支名称。

应用于仓库分支的组织规则集将不再允许仓库管理员重命名目标仓库的分支或将默认分支更改为另一个分支。仓库管理员可以创建和删除分支,只要他们拥有相应的权限。

重命名分支

  1. 在 GitHub.com 上,导航到仓库的主页。

  2. 从左侧的文件树视图中,选择 分支下拉菜单,然后点击 **查看所有分支**。您也可以在集成文件编辑器顶部找到分支下拉菜单。

    Screenshot of the file tree view for a repository. A dropdown menu for branches is expanded and outlined in dark orange.

  3. 在您要重命名的分支旁边,选择 下拉菜单,然后点击 重命名分支.

  4. 输入分支的新名称。

  5. 查看有关本地环境的信息,然后点击 **重命名分支**。

分支名称更改后更新本地克隆

在 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