Skip to main content

重命名分支

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

Who can use this feature

People with write permissions to a repository can rename a branch in the repository unless it is the default branch. People with admin permissions can rename the default branch.

关于重命名分支

您可以重命名 your GitHub Enterprise Server instance 上仓库中的分支。 有关分支的详细信息,请参阅“关于分支”。

当您在 your GitHub Enterprise Server instance上重命名分支时,任何包含旧分支名称的网址都会自动重定向到重命名分支的等效 URL。 还更新了分支保护政策以及打开的拉取请求(包括复刻的拉取请求)的基础分支和草稿版本。 重命名完成后, GitHub 在仓库主页上提供说明,指示贡献者更新他们的本地 Git 环境。

虽然文件 URL 会自动重定向,但原始文件 URL 未被重定向。 此外,如果用户对前一个分支名称执行 git pull,则 GitHub 不会执行任何重定向。

GitHub Actions 工作流不遵循重命名,因此,如果存储库发布了一个操作,任何使用 @{old-branch-name} 的操作都将中断。 您应该考虑添加带有原始内容的新分支,外加一个额外的提交报告,说明分支名称已弃用,并建议用户迁移到新的分支名称。

重命名分支

  1. 在 your GitHub Enterprise Server instance 上,导航到存储库的主页。 1. 在文件列表上方,单击 “分支”。 概述页面上的分支链接
  2. 在分支列表中,在要重命名的分支的右侧,单击 要重命名的分支右侧的铅笔图标
  3. 为分支输入新名称。 用于键入新分支名称的文本字段
  4. 查看有关本地环境的信息,然后单击“重命名分支”。 本地环境信息和“重命名分支”按钮

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

在您重命名 GitHub Enterprise Server 仓库中的分支后,拥有该仓库本地克隆的所有协作者都需要更新克隆。

从计算机上的仓库本地克隆中,运行以下命令以更新默认分支的名称。

$ 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