Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
 

 

重命名分支

本文内容

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

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

关于重命名分支

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

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

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

GitHub Actions 工作流不会跟随重命名，因此，如果您的仓库发布某个操作，任何人使用该操作结合 {old-branch-name} 都会崩溃。 您应该考虑添加带有原始内容的新分支，外加一个额外的提交报告，说明分支名称已弃用，并建议用户迁移到新的分支名称。

重命名分支

  1. 在 GitHub.com 上，导航到仓库的主页面。
  2. 在文件列表上方，单击 Branches（分支）。 概述页面上的分支链接
  3. 在分支列表中，在要重命名的分支的右侧，单击 。 要重命名的分支右侧的铅笔图标
  4. 为分支输入新名称。 输入新分支名称的文本字段
  5. 查看有关本地环境的信息，然后单击 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